From d5ef5bd16fc0f12c11fed7d07ebabc3ead7c6127 Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Tue, 25 Aug 1998 19:49:51 +0000 Subject: Commit for review --- doc/new_chapters/adminiface.t | 4 +- doc/new_chapters/confspace.t | 100 ++++++++++++++++++++--------------------- doc/new_chapters/dumpcontrol.t | 6 +-- doc/new_chapters/eventlog.t | 44 +++++++++--------- 4 files changed, 77 insertions(+), 77 deletions(-) (limited to 'doc') diff --git a/doc/new_chapters/adminiface.t b/doc/new_chapters/adminiface.t index 83f8c539ee..ce11b1b862 100644 --- a/doc/new_chapters/adminiface.t +++ b/doc/new_chapters/adminiface.t @@ -63,14 +63,14 @@ system. @subheading DESCRIPTION: -If {_POSIX_ADMIN} is defined: +If @code{_POSIX_ADMIN} is defined: The @code{admin_shutdown} function restarts the system. The @code{args} argument specifies alternate or optional behavior for the @code{admin_shutdown} function. The @code{admin_type} member of each element of the @code{args} array specifies the optional behavior to be performed. There are som @code{admin_types} - values that may provoke unspecified behavior. The @code[nargs} + values that may provoke unspecified behavior. The @code{nargs} argument specifies the length of the @code{args} array. Otherwise: diff --git a/doc/new_chapters/confspace.t b/doc/new_chapters/confspace.t index d42f8b944a..def9633bf9 100644 --- a/doc/new_chapters/confspace.t +++ b/doc/new_chapters/confspace.t @@ -69,9 +69,9 @@ Search permission is denied for a component of the path prefix. @item EEXIST The file specified by the file argument does not exist @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item ENOENT A component of cfgpath does not exist. @item ENOTDIR @@ -87,7 +87,7 @@ The cfg_mount() function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_mount} function maps a configuration space defined by the file identified by the the @code{file} argument. The @@ -137,9 +137,9 @@ Search permission is denied for a component of the path prefix. @item ENOENT A component of cfgpath does not exist. @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item EINVAL The requested node is not the distinguished node of a mounted configuration space. @@ -153,14 +153,14 @@ The cfg_umount function is not supported by this implementation. A node appears more than once in the path specified by the cfg_path argument @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_umount} function unmaps the configuration space whose distinguished node is mapped in the active space at the location defined @@ -195,9 +195,9 @@ int cfg_mknod( @table @b @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item ENOENT A compent of the path prefix does not exist. @item EACCES @@ -219,7 +219,7 @@ The function cfg_mknod() is not supported by this implementation. A node appears more than once in the path specified by the cfg_path argument @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @item EROFS The named node resides on a read-only configuration space. @@ -228,10 +228,10 @@ The named node resides on a read-only configuration space. @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_mknod} function creates a new node in the configuration - space which contains the pathname prefix of @cod{cfgpath}. T he node + space which contains the pathname prefix of @code{cfgpath}. T he node name shall be defined by the pathname suffix of @code{cfgpath}. The node name shall be defined by the pathname suffix of @code{cfgpath}. The node permissions shall be specified by the value of @code{mode}. @@ -264,9 +264,9 @@ int cfg_get( @table @b @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item ENOENT A component of cfgpath does not exist. @item EACCES @@ -279,14 +279,14 @@ The function cfg_get() is not supported by this implementation A node appears more than once in the path specified by the cfg_path argument @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_get} function stores the value attribute of the configuration node identified by @code{cfgpath}, into the buffer @@ -320,9 +320,9 @@ int cfg_set( @table @b @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item ENOENT A component of cfgpath does not exist @item EACCES @@ -335,14 +335,14 @@ The function cfg_set() is not supported by this implementation. A node appears more than once in the path specified by the cfg-path argument. @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_set} function stores the value specified by the @code{value} argument in the configuration node defined by the @@ -376,9 +376,9 @@ int cfg_link( @table @b @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters while -{_POSIX_NO_TRUNC} is in effect. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters while +@code{_POSIX_NO_TRUNC} is in effect. @item ENOENT A component of either path prefix does not exist. @item EACCES @@ -412,14 +412,14 @@ The function cfg_link() is not supported by this implementation. A node appears more than once in the path specified by the cfg-path argument. @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{src} and @code{dest}arguments point to pathnnames which name existing nodes. The @code{cfg_link} function shall atomically @@ -459,8 +459,8 @@ int cfg_unlink( @table @b @item ENAMETOOLONG -A component of a pathname exceeded {NAME_MAX} characters, -or an entire path name exceed {PATH_MAX} characters. +A component of a pathname exceeded @code{NAME_MAX} characters, +or an entire path name exceed @code{PATH_MAX} characters. @item ENOENT The named node does not exist. @item EACCES @@ -489,14 +489,14 @@ The function cfg_unlink() is not supported by this implementation. A node appears more than once in the path specified by the cfg-path argument. @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_unlink} function removes the link between the node specified by the @code{cfgpath} path prefix and the parent node @@ -540,8 +540,8 @@ Search permission is denied for any component of a pathname. A loop exists in symbolic links encountered during resolution of a pathname. @item ENAMETOOLONG -The length of a pathname exceeds {PATH_MAX}, or a pathname -component is longer than {NAME_MAX} while {_POSIX_NO_TRUNC} +The length of a pathname exceeds @code{PATH_MAX}, or a pathname +component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC} @item ENOENT The pathname argument is an empty string or the named node does not exist. @@ -553,18 +553,18 @@ Not enough memory is available to create the necessary structures. @item ENOSYS The function cfg_open() is not supported by this implementation. @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the pathnames argument. @item ENAMETOOLONG As a result of encountering a symbolic link in resolution of the pathname specified by the pathnames argument, the lenght of -the substituted pathname string exceeded {PATH_MAX}. +the substituted pathname string exceeded @code{PATH_MAX}. @end table @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The @code{cfg_open} function shall open a configuration traversal stream rooted in the configuration nodes name by the @code{pathnames} argument. @@ -588,7 +588,7 @@ If {_POSIX_CFG} is defined: be done. CFG_PHYSICAL - When symbolic links are encountered during the traversal, - the @codce{cfg_info} field shall describe the symbolic + the @code{cfg_info} field shall describe the symbolic link. @@ -668,18 +668,18 @@ Not enough memory is available to create the necessary structures. @item ENOSYS The function cfg_read() is not suported by this implementation. @item ELOOP -More than {SYMLOOP_MAX} symbolic links were encountered during +More than @code{SYMLOOP_MAX} symbolic links were encountered during resolution of the cfgpath argument. @item ENAMETOOLONG As aresult of encountering a symbolic link in resolution of the pathname specified by the pathnames argument, the length of the -substituted pathname string exceeded {PATH_MATH}. +substituted pathname string exceeded @code{PATH_MATH}. @end table @subheading DESCRIPTION: -if {_POSIX_CFG} is defined: +if @code{_POSIX_CFG} is defined: The @code{cfg_read} function returns a pointer to a CFGENT sturcture representing a node in the configuration space to which @code{cfgp} @@ -738,7 +738,7 @@ if {_POSIX_CFG} is defined: cfg_path - A pathname for the node including and relative to the argument supplied to the @code{cfg_open} routine for this configuration space. This pathname may be logner than - {PATH_MAX} bytes. This patname shall be NULL-terminated. + @code{PATH_MAX} bytes. This patname shall be NULL-terminated. cfg_name - The nodename of the node. cfg_pathlen - The length of the string pointed at by the @code{cfg_path} field when returned by @code{cfg_read}. @@ -829,8 +829,8 @@ The cfgp argument does not refer to an open configuration space. A loop exists in symbolic links encountered during resolution of a pathname. @item ENAMETOOLONG -The length of a pathname exceeds {PATH_MAX}, or a pathname -component is longer than {NAME_MAX} while {_POSIX_NO_TRUNC} is +The length of a pathname exceeds @code{PATH_MAX}, or a pathname +component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC} is in effect. @item EINVAL The specified value of the optiions argument is invalid. @@ -845,11 +845,11 @@ The function cfg_children() is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_CFG} is defined: +If @code{_POSIX_CFG} is defined: The first @code{cfg_children} call after a @code{cfg_read} shall return information about the first node without children under the - node returned by @code}{cfg_read}. Subsequent calls to + node returned by @code{cfg_read}. Subsequent calls to @code{cfg_children} without the intervening @code{cfg_read} shall return information about the remaining nodes without children under that same node. @@ -902,7 +902,7 @@ The function cfg_mark() is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_CF} is defined: +If @code{_POSIX_CF} is defined: The @code{cfg_mark} function modifies the subsequent behavior of the cfg functions with regard to the node referenced by the structure @@ -985,7 +985,7 @@ The function cfg_close() is not supported by this implementatioin. @subheading DESCRIPTION: -if {_POSIX_CFG} is defined: +if @code{_POSIX_CFG} is defined: The @code{cfg_close} function closes a configuration space transversal stream represented by the CFG structure pointed at by the @code{cfgp} diff --git a/doc/new_chapters/dumpcontrol.t b/doc/new_chapters/dumpcontrol.t index d196251cb4..677c170a68 100644 --- a/doc/new_chapters/dumpcontrol.t +++ b/doc/new_chapters/dumpcontrol.t @@ -54,8 +54,8 @@ Search permission is denied for a component of the path prefix, or write permission is denied on the directory containing the file. @item ENAMETOOLONG -The length of the argument exceeds {PATH_MAX} or a pathname -component is longer than {NAME_MAX} while {_POSIX_NO_TRUNC} +The length of the argument exceeds @code{PATH_MAX} or a pathname +component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC} is in effect. @item ENOENT The path argument points to an empty string. @@ -70,7 +70,7 @@ The directory entry specified resides on a read-only file system. @subheading DESCRIPTION: -If {_POSIX_DUMP} is defined: +If @code{_POSIX_DUMP} is defined: The @code{dump_setpath} function defines the pathname where process dumps are written. The pathname pointed to by @code{path} shall diff --git a/doc/new_chapters/eventlog.t b/doc/new_chapters/eventlog.t index a0b19da2fb..fe8c1240d6 100644 --- a/doc/new_chapters/eventlog.t +++ b/doc/new_chapters/eventlog.t @@ -67,9 +67,9 @@ int log_write( @item EINVAL The facility argument is not a valid log_facility. @item EINVAL -The severity argument exceeds {LOG_SEVERITY_MAX} +The severity argument exceeds @code{LOG_SEVERITY_MAX} @item EINVAL -The len argument exceeds {LOG_ENTRY_MAXLEN} +The len argument exceeds @code{LOG_ENTRY_MAXLEN} @item ENOSPC The log file has run out of space on the device. @item ENOSYS @@ -84,7 +84,7 @@ An I/O error occurred in writing to the system event log. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_write} function writes an event record, consisting of event attributes, and the data identified by the @code{buf} @@ -92,7 +92,7 @@ If {_POSIX_LOGGING} is defined: the length in bytes of the buffer pointed to by @code{buf}. The @code{len} argument shall specify the value of the event record length attribute. The value of @code{len} shall be less than or - equal to {LOG_ENTRY_MAXLEN} or the @code{log_write} shall fail. + equal to @code{LOG_ENTRY_MAXLEN} or the @code{log_write} shall fail. The @code{event_id} argument identifies the type of event record being written. The @code{event_id} argument shall specify the value @@ -108,7 +108,7 @@ If {_POSIX_LOGGING} is defined: event record. The @code{severity} argument shall specify the value of the event record severity attribute. The value of the @code{severity} argument shall be less than or equal to - {LOG_SEVERITY_MAX} or the @code{log_write} function shall fail. + @code{LOG_SEVERITY_MAX} or the @code{log_write} function shall fail. The effective_UID of the calling process shall specify the event record UID attribute. The efective-GID of the calling process @@ -156,15 +156,15 @@ The log_facility field of the query argument is not a valid facility set. @item EINVAL The log_severity field of the query argument exceeds -{LOG_SEVERITY_MAX}. +@code{LOG_SEVERITY_MAX}. @item EINVAL The path argument referred to a file that was not a log file. @item EMFILE Too many log file descriptors are currently in use by this process. @item ENAMETOOLONG -The length of the path string exceeds {PATH_MAX}, or a pathname -component is longer than {NAME_MAX} while {_POSIX_NO_TRUNC} is +The length of the path string exceeds @code{PATH_MAX}, or a pathname +component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC} is in effect. @item ENFILE Too many files are currently open in the system. @@ -179,7 +179,7 @@ The function log_open() is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_open} function establishes the connection between a log file and a log file descriptor. It creates an open log file @@ -251,7 +251,7 @@ An I/O error occurred in reading from the event log. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_read} function shall attempt to read the @code{log_entry} structure and @code{log_len} bytes of data from the next event record @@ -316,7 +316,7 @@ The function log_notify() is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: If the argument @code{notification} is not NULL this function registers the calling process to be notified of event records received by the system @@ -368,7 +368,7 @@ The function log_close() is not supported by t his implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_close} function deallocates the open log file descriptor indicated by @code{log_des}. @@ -422,7 +422,7 @@ The function log_seek() is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_seek} function shall set the log file offset of the open log descriptioin associated with the @code{logdes} log file descriptor @@ -463,7 +463,7 @@ int log_severity_before( @table @b @item EINVAL -The value of either s1 or s2 exceeds {LOG_SEVERITY_MAX}. +The value of either s1 or s2 exceeds @code{LOG_SEVERITY_MAX}. @item ENOSYS The function log_severity_before() is not supported by this implementation. @@ -472,7 +472,7 @@ implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The @code{log_severity_before} function shall compare the severity order of the @code{s1} and @code{s2} arguments. Severity values ordered @@ -517,7 +517,7 @@ The function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The facilitysetops primitives manipulate sets of facilities. They operate on data objects addressable by the application. @@ -582,7 +582,7 @@ The function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The facilitysetops primitives manipulate sets of facilities. They operate on data objects addressable by the application. @@ -648,7 +648,7 @@ The function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The facilitysetops primitives manipulate sets of facilities. They operate on data objects addressable by the application. @@ -714,7 +714,7 @@ The function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The facilitysetops primitives manipulate sets of facilities. They operate on data objects addressable by the application. @@ -781,7 +781,7 @@ The function is not supported by this implementation. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: The facilitysetops primitives manipulate sets of facilities. They operate on data objects addressable by the application. @@ -845,7 +845,7 @@ The is ???????????? @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: This function dynamically allocates memory for the @code{ld}, associates a directory path to the @code{Ld}, andprovides access permissions to the @@ -881,7 +881,7 @@ The directory path to the system log already exist. @subheading DESCRIPTION: -If {_POSIX_LOGGING} is defined: +If @code{_POSIX_LOGGING} is defined: This function will create a predefined system log directory path and system log file if they do not already exist. -- cgit v1.2.3