NAME

drv_getparm − Make drv_getparm(D3DK) calls available to shell scripts

SYNOPSIS

drv_getparm [-bcSN] DRVR_DIAG_CNTL <driver device file>
drv_getparm [-bcSN] CPU_FRU_STATUS

DESCRIPTION

drv_getparm(1M) allows shell scripts (e.g. scripts from /etc/init.d) to access information, that is only available to UNIX drivers by the drv_getparm(D3DK) call.  Variable assignment statements are generated as output to stdout, that shell scripts may make use of by calling eval (Bourne-Shell) or source (C-Shell).  The variable assignment syntax of both, Bourne-Shell and C-Shell is understood by drv_getparm(1M).  If no command line option is used to specify the Shell type, the environment variable SHELL is used.  If the environment variable SHELL does not exist, or contains a string, that is not understood by drv_getparm(1M), Bourne-Shell syntax is used as a fallback default. 

COMMAND LINE OPTIONS

The following command line options are available:

−b Ignore the SHELL environment variable, and select Bourne-Shell syntax for the variable assignments. 

−c Ignore the SHELL environment variable, and select C-Shell syntax for the variable assignments. 

−N Print the DRVR_DIAG_CNTL information in numeric form.  This is the default. 

−S Print the DRVR_DIAG_CNTL information in symbolic form. 

DRVR_DIAG_CNTL command

The DRVR_DIAG_CNTL command allows the retrieval of boot time diagnostic parameters for <driver device file>.  This file will be a character special device file (most likely from /etc/edt), that is used to find out the external major device number of the driver to retrieve boot time diagnostic parameters for.  Four different output formats may be selected with the combination of Shell selection (−b/−c) and format selection (−N/−S).  Sample output might look like this:

Bourne-Shell numeric output

# drv_getparm -b -N DRVR_DIAG_CNTL /dev/edt/mvme328_c0
DM_NORMAL=’0’; export DM_NORMAL;
DM_QUICK=’1’; export DM_QUICK;
DM_COMPR=’2’; export DM_COMPR;
D_MODE=’2’; export D_MODE;
DV_OFF=’0’; export DV_OFF;
DV_LEVEL1=’1’; export DV_LEVEL1;
DV_LEVEL2=’2’; export DV_LEVEL2;
DV_LEVEL3=’3’; export DV_LEVEL3;
DV_LEVEL=’2’; export DV_LEVEL;

Bourne-Shell symbolic output

# drv_getparm -b -S DRVR_DIAG_CNTL /dev/edt/mvme328_c0
D_MODE=’DM_COMPR’; export D_MODE;
DV_LEVEL=’DV_LEVEL2’; export DV_LEVEL;

C-Shell numeric output

# drv_getparm -c -N DRVR_DIAG_CNTL /dev/edt/mvme328_c0
setenv DM_NORMAL ’0’;
setenv DM_QUICK ’1’;
setenv DM_COMPR ’2’;
setenv D_MODE ’2’;
setenv DV_OFF ’0’;
setenv DV_LEVEL1 ’1’;
setenv DV_LEVEL2 ’2’;
setenv DV_LEVEL3 ’3’;
setenv DV_LEVEL ’2’;

C-Shell symbolic output

# drv_getparm -c -S DRVR_DIAG_CNTL /dev/edt/mvme328_c0
setenv D_MODE ’DM_COMPR’;
setenv DV_LEVEL ’DV_LEVEL2’;

CPU_FRU_STATUS command

The CPU_FRU_STATUS command allows the retrieval of CPU board FRU (field replaceable unit) information by printing it to stdout in form of Shell variable assignments.  Two different output formats may be selected with −b and −c.  Sample output might look like this:

Bourne-Shell output

# drv_getparm -b CPU_FRU_STATUS
FRU_NAME=’MVME187’; export FRU_NAME;
FRU_PRESENT=’yes’; export FRU_PRESENT;
FRU_ONLINE=’yes’; export FRU_ONLINE;
FRU_LOCATION=”; export FRU_LOCATION;
FRU_REVISION=’,firmware,Version 2.1 - 01/11/94’; export FRU_REVISION;
FRU_SELF_TEST=’,status,untested’; export FRU_SELF_TEST;

C-Shell output

# drv_getparm -c CPU_FRU_STATUS
setenv FRU_NAME ’MVME187’;
setenv FRU_PRESENT ’yes’;
setenv FRU_ONLINE ’yes’;
setenv FRU_LOCATION ”;
setenv FRU_REVISION ’,firmware,Version 2.1 - 01/11/94’;
setenv FRU_SELF_TEST ’,status,untested’;

SEE ALSO

drv_getparm(D3DK)