systemitem

systemitem — A system-related item or term.

Synopsis

systemitem ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • At most one of:
    • class (enumeration)
      • “daemon”
      • “domainname”
      • “etheraddress”
      • “event”
      • “eventhandler”
      • “filesystem”
      • “fqdomainname”
      • “groupname”
      • “ipaddress”
      • “library”
      • “macro”
      • “netmask”
      • “newsgroup”
      • “osname”
      • “process”
      • “protocol”
      • “resource”
      • “securitycontext”
      • “server”
      • “service”
      • “systemname”
      • “username”
    • All or none of:
      • class (enumeration)
        • “other”
      • otherclass (NMTOKEN)

Description

A systemitem identifies any system-related item or term. The class attribute defines a number of common system-related terms.

Many inline elements in DocBook are, in fact, system related. Some of the objects identified by the class attribute on systemitem may eventually migrate out to become separate inline elements, and some inline elements may migrate into systemitem.

Processing expectations

Formatted inline.

Attributes

Common attributes and common linking attributes.

class

Identifies the nature of the system item

Enumerated values:
“daemon”

A daemon or other system process (syslogd)

“domainname”

A domain name (example.com)

“etheraddress”

An ethernet address (00:05:4E:49:FD:8E)

“event”

An event of some sort (SIGHUP)

“eventhandler”

An event handler of some sort (hangup)

“filesystem”

A filesystem (ext3)

“fqdomainname”

A fully qualified domain name (my.example.com)

“groupname”

A group name (wheel)

“ipaddress”

An IP address (127.0.0.1)

“library”

A library (libncurses)

“macro”

A macro

“netmask”

A netmask (255.255.255.192)

“newsgroup”

A newsgroup (comp.text.xml)

“osname”

An operating system name (Hurd)

“process”

A process (gnome-cups-icon)

“protocol”

A protocol (ftp)

“resource”

A resource

“securitycontext”

A security context (a role, permission, or security token, for example)

“server”

A server (mail.example.com)

“service”

A service (ppp)

“systemname”

A system name (hephaistos)

“username”

A user name (ndw)

otherclass

Identifies the nature of the non-standard system item

Children

The following elements occur in systemitem: text, abbrev, acronym, alt, anchor, annotation, biblioref, co, coref, date, emphasis (db._emphasis), firstterm (db._firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), glossterm (db._glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlinemediaobject, link, olink, phrase (db._phrase), quote (db._quote), remark, replaceable, subscript, superscript, trademark, wordasword, xref.

Examples

<article xmlns='http://docbook.org/ns/docbook'
         xmlns:xlink='http://www.w3.org/1999/xlink'>
<title>Example systemitem</title>

<para>For many years, O'Reilly's primary web server, 
<link xlink:href="http://www.oreilly.com/">http://www.oreilly.com/</link>,
was hosted by <application>WN</application> on
<systemitem class="systemname">helio.oreilly.com</systemitem>.
</para>

</article>

For many years, O'Reilly's primary web server, http://www.oreilly.com/, was hosted by WN on helio.oreilly.com.

Last revised by Norman Walsh on (git hash: 4a070f84c9fc7bc85cf9f71d71fa54f4db18f973 a835fdf61c7f87ce1038e2869080d80ea67d3696)