unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



stanza(4)							    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 special 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 spe-
  cial 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:


       \007

RELATED	INFORMATION

  Commands: sysconfigdb(8), cfgmgr(8)

  Functions: libAF(3)

  Files:  /etc/sysconfigtab(4)