MSO Management HAL APIs

Description

Functions
mso_pwd_ret_status	mso_validatepwd (char *pwd)
int	mso_set_pod_seed (char *)
int	mso_get_pod_seed (char *pSeed)

Function Documentation

mso_validatepwd()

mso_pwd_ret_status mso_validatepwd

(

char *

pwd

)

@description Validate whether the password passed in matches the password of the day for mso user.

Parameters

pwd	- Pointer to a buffer that was preallocated by the caller.

Returns

The status of the operation.

Return values

mso_pwd_ret_status

Invalid_PWD, Good_PWD, Unique_PWD, Expired_PWD, TimeError

Execution:\n Synchronous.

Side Effects:\n None.

mso_set_pod_seed()

int mso_set_pod_seed

(

char *

)

@description Sets the PoD seed for mso password validation.

Parameters

CHAR*

- PoD seed

Returns

the status of the operation.

Return values

RETURN_OK	if successful.
RETURN_ERR	if any error is detected.

Execution:\n Synchronous.

Side Effects:\n None.

Note

This function must not suspend and must not invoke any blocking system calls. It should probably just send a message to a driver event handler task. Newer Broadband Devices MUST decrypt the seed on demand when this HAL is called.

mso_get_pod_seed()

int mso_get_pod_seed

(

char *

pSeed

)

@description Gets the PoD seed for mso password validation.

Parameters

CHAR*

pSeed - a pointer to a buffer that was preallocated by the caller. This is where the output is written

Returns

the status of the operation.

Return values

RETURN_OK	if successful.
RETURN_ERR	if any error is detected.

Execution:\n Synchronous.

Side Effects:\n None.

Note

This function retrieves the decrypted seed set in the Config file and SNMP OID rdkbEncryptedClientSeed. pSeed for security reasons MUST be manually overwritten after use.