Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

smi_render(3) [centos man page]

smi_render(3)						SMI Management Information Library					     smi_render(3)

NAME
smiRenderOID, smiRenderValue, smiRenderNode, smiRenderType - SMI data and MIB data rendering routines SYNOPSIS
#include <smi.h> char *smiRenderOID(unsigned int oidlen, SmiSubid *oid, int flags); char *smiRenderValue(SmiValue *smiValuePtr, SmiType *smiTypePtr, int flags); char *smiRenderNode(SmiNode *smiNodePtr, int flags); char *smiRenderType(SmiType *smiTypePtr, int flags); DESCRIPTION
These functions provide can be used to render OIDs, values of MIB data, or names of MIB nodes or types. The smiRenderOID() function renders an OID given by its length oidlen and its array of sub-identifiers oid*. The flags can be used to con- trol the resulting format, see FORMATS below. The smiRenderValue() function renders a MIB data value given by smiValuePtr. An underlying type smiTypePtr may be supplied to support a more human friendly rendering. The flags can be used to control the resulting format, see FORMATS below. The smiRenderNode() function renders the name of a node given by smiNodePtr. The flags can be used to control the resulting format, see FORMATS below. The smiRenderType() function renders the name of a type given by smiTypePtr. The flags can be used to control the resulting format, see FORMATS below. FORMATS
Each of these functions gets a last argument named flags. This is a logcially or-ed set of flags that can be used to control the format of the rendered items: SMI_RENDER_NUMERIC Allow numeric representation (default). SMI_RENDER_NAME Allow a representation by name(s) if possible. SMI_RENDER_QUALIFIED In case of a name representation, force a module prefix, e.g. IF-MIB::ifIndex instead of just ifIndex. SMI_RENDER_FORMAT In case of smiRenderValue(), force the application of a format specification (e.g. an SMIv2 DISPLAY-HINT) of an underlying type if the smiTypePtr argument is not NULL and this type contains such a format specification. SMI_RENDER_PRINTABLE In case of octet string value rendering, force a printable representation if all octets of the octet string are printable. SMI_RENDER_UNKNOWN Force the return of a string containing SMI_LABEL_UNKNOWN ("<unknown>"), if the rendering would fail. This way, the only condition where NULL can be returned is the lack of memory. SMI_RENDER_ALL Apply a combination of all these flags. This supports the (hopefully) most human friendly representations. RETURN VALUE
All of these functions return a string, if successful, or NULL in case of a rendering failure. See also the SMI_RENDER_UNKNOWN flag above. SEE ALSO
libsmi(3), smi.h AUTHOR
(C) 2002 Frank Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de> IBR
July 24, 2002 smi_render(3)

Check Out this Related Man Page

smi_render(3)						SMI Management Information Library					     smi_render(3)

NAME
smiRenderOID, smiRenderValue, smiRenderNode, smiRenderType - SMI data and MIB data rendering routines SYNOPSIS
#include <smi.h> char *smiRenderOID(unsigned int oidlen, SmiSubid *oid, int flags); char *smiRenderValue(SmiValue *smiValuePtr, SmiType *smiTypePtr, int flags); char *smiRenderNode(SmiNode *smiNodePtr, int flags); char *smiRenderType(SmiType *smiTypePtr, int flags); DESCRIPTION
These functions provide can be used to render OIDs, values of MIB data, or names of MIB nodes or types. The smiRenderOID() function renders an OID given by its length oidlen and its array of sub-identifiers oid*. The flags can be used to con- trol the resulting format, see FORMATS below. The smiRenderValue() function renders a MIB data value given by smiValuePtr. An underlying type smiTypePtr may be supplied to support a more human friendly rendering. The flags can be used to control the resulting format, see FORMATS below. The smiRenderNode() function renders the name of a node given by smiNodePtr. The flags can be used to control the resulting format, see FORMATS below. The smiRenderType() function renders the name of a type given by smiTypePtr. The flags can be used to control the resulting format, see FORMATS below. FORMATS
Each of these functions gets a last argument named flags. This is a logcially or-ed set of flags that can be used to control the format of the rendered items: SMI_RENDER_NUMERIC Allow numeric representation (default). SMI_RENDER_NAME Allow a representation by name(s) if possible. SMI_RENDER_QUALIFIED In case of a name representation, force a module prefix, e.g. IF-MIB::ifIndex instead of just ifIndex. SMI_RENDER_FORMAT In case of smiRenderValue(), force the application of a format specification (e.g. an SMIv2 DISPLAY-HINT) of an underlying type if the smiTypePtr argument is not NULL and this type contains such a format specification. SMI_RENDER_PRINTABLE In case of octet string value rendering, force a printable representation if all octets of the octet string are printable. SMI_RENDER_UNKNOWN Force the return of a string containing SMI_LABEL_UNKNOWN ("<unknown>"), if the rendering would fail. This way, the only condition where NULL can be returned is the lack of memory. SMI_RENDER_ALL Apply a combination of all these flags. This supports the (hopefully) most human friendly representations. RETURN VALUE
All of these functions return a string, if successful, or NULL in case of a rendering failure. See also the SMI_RENDER_UNKNOWN flag above. SEE ALSO
libsmi(3), smi.h AUTHOR
(C) 2002 Frank Strauss, TU Braunschweig, Germany <strauss@ibr.cs.tu-bs.de> IBR
July 24, 2002 smi_render(3)
Man Page

Featured Tech Videos