Name

mcsysinfocfg — MagniCompSysInfo™ runtime configuration file

Synopsis

#
# Comment line
#
key=value

DESCRIPTION

The MagniComp SysInfo runtime configuration (RC) file allows customization of runtime arguments and options for the SysInfo Command Line Interface (mcsysinfocli(1)) and the SysInfo Graphical User Interface (mcsysinfogui(1)).

Command line arguments take precedence over options read from mcsysinfo.cfg files.

The following files are read (in order) when mcsysinfo is executed:

  1. /opt/sysinfo/config/mcsysinfo.cfg

  2. /etc/mcsysinfo/mcsysinfo.cfg

  3. $HOME/.mcsysinfo/mcsysinfo.cfg

The most recently read value takes precedence over previously read values.

Lines beginning with a hash (#) character are taken as comment lines and are ignored.

COMMANDS

Each line of the RC file has the form:

	key=value

The key is case insensitive. If key is a boolean, than the possible values for value are yes, no, true, and false. Boolean values are case insensitive.

Some key options corresponds to a command line option. The following table describes each key value and its corresponding command line option (if any):

KEYCOMMAND LINEVALUE TYPEDESCRIPTIONEXAMPLE
Cache--cachebooleanEnable (YES) or disable (NO) caching of class and license data. The default is to cache data.NO
CacheDir--cachedirdirUse dir as the top level cache directory. /var/tmp
ConfigDir--configdirdir Specify the name of the directory to use to find sysinfo.cf format configuration files./local/sysinfo/config
DriverPath pathUse path as a comma `,' seperated list of directories to search for SysInfo drivers. This value may only be set in the /opt/sysinfo/config/mcsysinfo.cfg file./sw/sysinfo/drivers,/local/sysinfo/drivers
DevIgnore listIgnore each device which has one of the names specified in list. Ignored devices may still go through a discovery process but will not be reported. The list is a comma `,' seperated list of names. sd0,eth7
Encode--encodeEncodeTypeEncode output in the manor specified by EncodeType. Valid values are:
htmlHTML
textASCII Text
html
ExecPath pathUse path as a comma (,) seperated list of directories to search for the actual binary executables to run. /opt/sysinfo/libexec/platform/${OSNAME}-${OSVERSION}-${CPUARCH},/opt/sysinfo/libexec/platform/${OSNAME}-${OSMAJVERSION}-${CPUARCH},/opt/sysinfo/libexec/platform/${OSNAME}-${CPUARCH}
ExpireTime--expiretimesecondsExpire cached data after seconds.1000
Format--formatFormatTypeSpecify the format layout and display of requested data. Valid FormatType values are: pretty (deprecated), report, tree.columns
GUI--guibooleanIf YES is specified, the Graphical User Interface will be run if the user's environment is configured with $DISPLAY and the local system supports it. Setting this option to NO disables the GUI and forces the Command Line Interface (CLI) to be used.NO
HaveSharedLib YES | NODoes this system supported shared (dynamic) libraries?YES
Hints--hintsbooleanIf YES is specified (the default) then hints about how to use the CLI will be displayed to standard error (stderr). Such hints will be prefixed with HINT. If NO is specified, no hints will be displayed.NO
Host--hosthostnameRetrieve information from host which may be either a hostname or IP address. The host must be running the mcsysinfod(8) SysInfo server agent. If this option is not specified, SysInfo scans the local system directly without talking to mcsysinfod(8). desktop101
LicPorts--licportsstart-endSpecify the range of ports to scan for license servers where start is the port number to start with and end is a port number to end at.7000-7200,7300-7999
MsgClass--msgclassMsgClassListSpecify which class of messages should be output. See mcsysinfocli(1) for details.all
MsgLevel--msglevelMsgLevelListSet the level of messages that are shown. See mcsysinfocli(1) for details.all
NoSerial--noserialbooleanDisable checking for duplicate devices using serial numbers. 
OffSet--offset#spacesSet the number of spaces to offset (indent) when printing device information.12
Password--passwordpasswordUse password as the plain text password when user authentication is required by mcsysinfod(8). This option is only needed when used with --host and --username options.funinsun
Port--portport#Use port# as the port that mcsysinfod(8) is listening on. This option is only applicable with the --host option.12000
RepSep--repsepstringChange the field separator string used with --format report to be string.,
SiePath--siepathpathUse path as the pathname to the SysInfo Engine (SIE)./local/sysinfo/libexec/sie
SharedLibPath pathUse path as a colon seperated list of directories which contain shared libraries. /opt/sysinfo/lib/libexec:/local/sysinfo/lib/libexec
SiteInfoSetScopes scopesRestrict what SysInfo SiteInfo files can be updated via --siteinfo-* options. scopes is a comma seperated list which may contain:
userAllow updates of $HOME/.mcsysinfo/mcsysinfo.cfg
systemAllow updates of /etc/mcsysinfo/mcsysinfo.cfg
systemAllow updates of /opt/sysinfo/config/mcsysinfo.cfg
This value may only be set in the /opt/sysinfo/config/mcsysinfo.cfg file.
user,system
SnmpMibsDir pathUse path as the directory containing SysInfo's SNMP MIBS files./local/sysinfo/config/mibs
SwFiles--swfilesbooleanWhen YES is specified and software class information is being displayed, a list of files and file data is displayed for all files belonging to each package.YES
Unknown--unknownbooleanShow devices that appear to be present on the system, but are not "known" to SysInfo. 
Unused--unusedbooleanShow entries (such as partitions) that do not appear to be in use. 
UseProm--useprombooleanObtain data from the system PROM instead of interpreting values obtained directly from the kernel. 
Username--usernameuserUse user as the username to authenticate with when authentication is required by mcsysinfod(8). This option is only needed when used with --host and --password options.fred

FILES

/etc/mcsysinfo/mcsysinfo.cfgSystem RC file
/opt/sysinfo/config/mcsysinfo.cfgInstallation RC file
$HOME/.mcsysinfo/mcsysinfo.cfgUser's RC file

SEE ALSO

mcsysinfo(1) mcsysinfocli(1) mcsysinfogui(1)

URL

http://www.MagniComp.com/sysinfo