Switch Register Functions

Functions
nmf_status_t	nmf_reg_sz_get (nmf_client_t client_id, int slot_id, char *reg_name, char **val_ptr, int *val_len)
	Read a Switch Register as a String.

---

Function Documentation

nmf_status_t nmf_reg_sz_get	(	nmf_client_t	client_id,
		int	slot_id,
		char *	reg_name,
		char **	val_ptr,
		int *	val_len
	)

Read a Switch Register as a String.

This function reads a silicon specific switch register and returns the value read as a string. The name of the switch register and its format is silicon vendor dependent and processed by the silicon provider driver on the server.

If the function returns NMF_OK, val_ptr is updated with a pointer to statically allocated storage containing the data and val_len with the length of the data. The storage does not need to be freed, however, it's contents will be overwritten on a subsequent call to this interface.

Parameters:

	client_id	The client handle.
	slot_id	The slot number
	reg_name	The switch register definition string
	val_ptr	Pointer to a string pointer.
	val_len	The length of the string.

Returns:

NMF_OK Success

-NMF_EINVAL An invalid parameter or register name was specified.