getbsvalue: getbsflag, getbsvalue, getbsword --
get configuration information from the bootstring
int getbsword(const char module, const char name, char buffer,
int getbsflag(const char module, const char name);
char getbsvalue(const char module, const char name);
These routines access configuration information passed in the
bootstring, as described in
module and name
point to module.name pairs
in the bootstring.
points to a buffer in which
buflen-1 bytes of the bootstring value
will be placed.
This buffer is always zero-terminated.
indicates how many bytes (minus 1) of
the rightmost word of the bootstring get placed in
return one of the following values:
No word was found corresponding to the specified
module and name.
A word was found, but there was no associated value.
A matching word and its associated value were found;
getbsword places buflen-1 bytes of
value in buffer.
returns a string that represents the bootstring value.
(char *) -1.
After the parsing and editing described on the
the command line used to boot the kernel
is passed to the kernel as the bootstring.
The bootstring consists of a series of words
of the following form:
Normally, device drivers should use
their internal name as the module;
this is the internal name (xname)
specified in the first field of the
A word not preceded by a module
is assumed to be in the kernel module.
A NULL value for module
indicates the kernel module.
places buflen-1 bytes of the
rightmost word in the bootstring matching the specified
module and name, into buffer.
return whether or not the requested word existed,
and, if it did, whether it had a value.
returns a pointer to the word's value
if the preceding
should only be called if the corresponding
Context and synchronization
These functions may be called at any time
on any CPU at any
level. They do not sleep (see
No interlocking is required.
3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp
Differences between versions
An older version of
returned the leftmost word in the bootstring.
This is inconsistent with boot,
so these functions have been changed
to return the rightmost word.
The older routines did not allow a quoted value,
and a NULL module argument was illegal;
these are now supported.
``ODDI driver interface version for SCO OpenServer 5'' in HDK Technical Reference
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 5 HDK - June 2005