stanza(4) [osf1 man page]
stanza(4) Kernel Interfaces Manual stanza(4) NAME
stanza - Stanza file format SYNOPSIS
stanza DESCRIPTION
A stanza file format is used in conjunction with the libAF(3) stanza file library. The stanza file syntax rules are as follows: Separate entries by one or more blank lines. A colon (:) terminates a entry name. A newline terminates an attribute name and value pair. Separate a attribute name and attribute value with an equal sign (=). Separate more than one attribute value with a comma (,). Entry names and attribute names can contain any printable character, except whitespace, a newline, or special characters, unless specified appropriately. Entry attribute values can contain any printable character, except a newline or spe- cial characters, unless specified appropriately. Trailing blanks or tabs are allowed at the beginning or end of lines. A number sign (#) at the beginning of a line indicates a comment. Comments should be included only at the beginning or the end of an entry. The syntax for a stanza file entry is as follows: entry_name: Attribute1_name = Attribute1_value Attribute2_name = Attribute2_value Attribute3_name = Attribute3_value1, Attribute3_value2 . . . The entry_name variable specifies the entry name. The attributes for the entry are specified with the Attribute1_name, Attribute2_name, and Attribute3_name variables. The values for the attributes are specified with the Attribute1_value, Attribute2_value, Attribute3_value1, and Attribute3_value2 variables. Several special quoting characters allow attribute values to contain special values and data representations. If you specify a quoting character, surround the attribute value with quotes. For example, to specify an octal value use the slash character: 07 RELATED INFORMATION
Commands: sysconfigdb(8), cfgmgr(8) Functions: libAF(3) Files: /etc/sysconfigtab(4) delim off stanza(4)
Check Out this Related Man Page
sysconfigtab(4) Kernel Interfaces Manual sysconfigtab(4) NAME
sysconfigtab - Configurable subsystem definition database file SYNOPSIS
/etc/sysconfigtab DESCRIPTION
The sysconfigtab file contains initial values for the attributes of subsystems that can be dynamically configured. The information in the sysconfigtab file is loaded into an in-memory kernel database when the system boots. At subsystem configuration time, values in the in- memory kernel database override default values coded into the subsystem. There are multiple numbered versions of the sysconfigtab.* file in the /etc directory, but only the /etc/sysconfigtab version is used dur- ing normal operations. The versions are present to support the dynamic linking of modules to create a /vmunix kernel. This feature is called bootlinking and is documented in Guide to Preparing Product Kits. You may not be able to use bootlinking if you delete any copies of the sysconfigtab.* file. Avoid making manual changes to this file. Instead, use the command sysconfigdb(8) to make changes. This utility will automatically make any changes available to the kernel and will preserve the structure of the file so that future upgrades will merge in correctly. The sysconfigtab file consists of formatted entries. The first line in an entry specifies the subsystem name. Subsequent lines specify the subsystems' attributes and values. Comment lines are allowed within an entry. The following shows the syntax of a subsystem entry: subsys- tem-name: #This is a comment describing the subsystem attribute1 = value1 attribute2 = value2, value3 The following list details sysconfigtab entries: The subsystem name is terminated with a colon (:). Each attribute name and value pair are terminated with a newline character. Attribute names are separated from values with an equal sign (=). No space is allowed in the middle of an attribute name, including an array attribute name. For instance, array attribute names such as attr1[1] and attr1[2] are permitted, but attr1 [1] or attr1[ 2 ] are not. For example, the following line in /etc/sysconfigtab is permitted: attr1[0] = 2 Attributes that have more than one value separate the values with a comma (,). Quotation marks are not used (") in string values. Blank or tab characters may occur in the middle of a string, but leading or trailing blanks are ignored. A number sign (#) appears at the beginning of comment lines. Comments that are specific to the subsystem are placed after the line containing the subsystem name. The sysconfigdb command con- siders a sysconfigtab entry to begin with the subsystem name and end with either the next subsystem name or the end of the file. Any comments that appear before a subsystem name are considered to be part of the preceding subsystem and are deleted if the preced- ing subsystem is deleted. For a list of the subsystem attributes you can configure, see the System Administration manual. Refer also to the various sys_attrs refer- ence pages, which list the system attributes and their default or maximum values. The graphical user interface dxkerneltuner provides you with an easy way to review and adjust attribute values. For information about loadable device driver attributes, see the Writing Device Drivers: Tutorial manual. In a cluster environment, an additional clusterwide file, sysconfigtab.cluster, is used to contain those attributes that must be set to the same values in each member's /etc/sysconfigtab file. When a cluster member boots, the contents of its /etc/sysconfigtab file is synchro- nized against the clusterwide sysconfigtab.cluster file. RESTRICTIONS
The maximum length of a stanza entry is 40960 bytes. An entry cannot contain more than 2048 fields (lines). The maximum length of a stanza field is 500 bytes. EXAMPLES
The following shows an example stanza entry that could appear in the configurable subsystem database: proc: max-proc-per-user = 64 max-threads-per-user = 256 The preceding entry defines the max-proc-per-user and max-threads-per-user attributes for the proc subsystem. RELATED INFORMATION
Commands: dxkerneltuner(8), sys_attrs(5), sysconfig(8), sysconfigdb(8), cfgmgr(8) Files: stanza(4) System Administration Writing Device Drivers: Tutorial delim off sysconfigtab(4)