OSF

NAME

stanza − Stanza file format

SYNOPSIS

stanza

DESCRIPTION

A stanza file format is used in conjunction with the stanza file library, libAF(3). 

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 a stanza name and value pair. 

       •Separate a attribute name and attribute value with = (equal sign). 

       •Separate multiple attribute values with , (comma). 

       •Entry names and attribute names may contain any printable character other than whitespace, newline, or special characters unless appropriately quoted. 

       •Entry attribute values may contain any printable character other than newline, or special characters unless appropriately quoted. 

       •Trailing blanks or tabs are allowed at the beginning or end of the line. 

       •A # (pound sign) at the beginning of a line indicates a comment. 

Each stanza file entry in the file is usually of the form:

Entry_name:
         Attribute1_name = Attribute1_value
         Attribute2_name = Attribute2_value
         Attribute3_name = Attribute3_value1, Attribute3_value2

In this sample, Entry_name is the entry name and its attributes are: Attribute1_name, Attribute2_name, and Attribute3_name.  Each attribute has its respective attribute values listed after the equal sign.  Notice that the attribute name Attribute3_name has two distinct values associated with it: Attribute3_value1 and Attribute3_value2. 

Several special quoting characters exist to allow attribute values contain special values and data representations.  When using any quoting characters, encapsulate the attribute value with quotes; for example, "quoted value".  To specify an octal value use the slash character; for example, "\007". 

RELATED INFORMATION

Commands: sysconfigdb(8)

Functions: libAF(3)

Files:  sysconfigtab(4)