Imagelibrary/rtems
1
0
Fork 1
mirror of https://gitlab.rtems.org/rtems/rtos/rtems.git synced 2025-12-29 16:00:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Commit for review

Browse Source
This commit is contained in:
Joel Sherrill
1998-08-25 19:49:51 +00:00
parent 2a23c28060
commit d5ef5bd16f
4 changed files with 77 additions and 77 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
doc/new_chapters/adminiface.t
View File

@@ -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:

100
doc/new_chapters/confspace.t
View File

@@ -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}

6
doc/new_chapters/dumpcontrol.t
View File

@@ -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

44
doc/new_chapters/eventlog.t
View File

@@ -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.