.\" .TH mcsysinfocf 5 "12 April 2003" .ds ]W www.MagniComp.com .SH NAME mcsysinfocf \- MagniComp(tm) SysInfo(tm) configuration file .SH SYNOPSIS \fBConfDir \fIPathName\fR .br .sp \fBDefine | \fIType | StringKey | NumericKey | Value1 | Value 2\fR .br .sp \fBDevice | \fIName | Type\fB/[\fISubType\fB]\fI | NumericID | Model | Description | Flags | DevFiles\fR .br .sp \fBInclude \fIFileName\fR .SH DESCRIPTION .B sysinfo.cf files contain configuration databases used by .B MagniComp(tm)'s .B SysInfo(tm) program .B mcsysinfo(1) and its APIs. The data is used by .B SysInfo(tm) to interpret and/or acquire data about a system's configuration. .PP Text starting with ``#'' and continuing to the end of the line is ignored. Each line starts with a specific keyword as described below. All leading and trailing white space (space and TAB characters) for each field is removed before parsing. All keywords are case insensitive. The valid keywords are: .IP "\fBConfDir \fIPathName\fR" Set the name of the directory to look for configuration files in to be \fIPathName\fR. This also sets the value of the .B ${ConfDir} variable available for use with the .B Include keyword. The default is .B /opt/sysinfo/config .IP "\fBDefine \fIfields\fR" Definetion. Each field is seperated by a ``|'' character. Any fields that are not specified are initialized to NULL. The .I StringKey NetType, OBP, Part, SysConf, SysModel, TapeInfo, VPD \fR .IP \fIStringKey\fR A string to use as a key. .IP \fINumericKey\fR A numeric value to use as a key. .IP \fIValue1\fR A string to return for the entry. .IP \fIValue2\fR A string to return for the entry. .RE .IP "\fBDevice \fIfields\fR" Device specification. Each field is seperated by a ``|'' character. Any fields that are not specified are initialized to NULL. The specification for each field follows: .RS .IP \fIName\fR The name of the device. ( e.g. .B sd, .B cgsix ) .IP "\fIType\fB/[\fISubType\fB]\fR" The type of device. The .I Type value is used to determine how to .I probe the device and what device type label to assign to it. If .I SubType is specified, then the .I Type field specifies how to .I probe the device and the .I SubType field specifies what device type label to assign. The valid keywords are: .br \fB Bus, CDROM, CPU, Device, returned from the kernel. .IP \fIModel\fR The device's model. .IP \fIDescription\fR A description of the device. .IP \fIFlags\fR The .I Flags field may contain either a valid keyword or a numeric value. Numeric values are used in a device-type specific manner by the device type's probe routine. The valid keywords are: .RS .IP \fBDefInfo\fR Use default device definetion information. Usage varies by device type. .IP \fBLenCmp\fR Compare device name by length. .IP \fBNoUnit\fR Don't add a unit number to the device's name. .IP \fBZombie\fR If the device is present, treat it as if it were alive regardless of whether the kernel has indicated so. .RE .IP \fIDevFiles\fR A list of space seperated device files that provide access to the device. Each file may contain a .B `%d' which will be expanded to be the device's unit number. .RE .IP "\fBInclude \fIFileName\fR" Read and parse a .B sysinfo.cf file called .I FileName. Parsing of the current file resumes on the next line when finished with .I FileName. If .I FileName does not exist, .B MagniComp(tm) .B SysInfo will silently continue parsing the current file. .I FileName may contain variables that are expanded at runtime. Variable names are enclosed inside of .B ${} or .B $() ) .IP \fB${OSname}\fR The name of the operating system. ( e.g. .B SunOS ) .IP \fB${OSver}\fR The operating system version number. ( e.g. .B 4.1.3 ) .IP \fB${OSmajver}\fR The operating system major version number. ( e.g. for .B 4.1.3 the value would be .B 4 ) .RE .SH AUTHOR MagniComp .br www.MagniComp.com .SH "URL" .B http://www.magnicomp.com/sysinfo .SH SEE ALSO mcsysinfo(1), mcsysinfoc(3)