From 90c60f7931c059a2c7d62fb7afb4e8eaca046b2d Mon Sep 17 00:00:00 2001 From: Wade A Smith Date: Mon, 31 Aug 1998 15:39:03 +0000 Subject: Updated the descriptions section for the log_create and log_sys_create functions.d --- doc/new_chapters/eventlog.t | 67 +++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 62 insertions(+), 5 deletions(-) (limited to 'doc/new_chapters/eventlog.t') diff --git a/doc/new_chapters/eventlog.t b/doc/new_chapters/eventlog.t index ec7a3a75f2..556a6ea8b8 100644 --- a/doc/new_chapters/eventlog.t +++ b/doc/new_chapters/eventlog.t @@ -19,6 +19,8 @@ Available, and Serviceable Systems}. The directives provided by the event logging manager are: @itemize @bullet +@item @code{log_create} - Create a log file +@item @code{log_sys_create} - Create a system log file @item @code{log_write} - Write to the system Log @item @code{log_write_any} - Write to any log file @item @code{log_write_entry} - Write entry to any log file @@ -1029,16 +1031,71 @@ int log_create( @subheading STATUS CODES: @table @b -@item ENOMEM -The is ???????????? + +@item +EEXIST +The @code{path} already exists and O_CREAT and O_EXCL were used. + +@item +EISDIR +The @code{path} refers to a directory and the access requested involved +writing. + +@item +ETXTBSY +The @code{path} refers to an executable image which is currently being +executed and write access was requested. + +@item +EFAULT +The @code{path} points outside your accessible address space. + +@item +EACCES +The requested access to the file is not allowed, or one of the +directories in @code{path} did not allow search (execute) permission. + +@item +ENAMETOOLONG +The @code{path} was too long. + +@item +ENOENT +A directory component in @code{path} does not exist or is a dangling symbolic +link. + +@item +ENOTDIR +A component used as a directory in @code{path} is not, in fact, a directory. + +@item +EMFILE +The process already has the maximum number of files open. + +@item +ENFILE +The limit on the total number of files open on the system has been reached. + +@item +ENOMEM +Insufficient kernel memory was available. + +@item +EROFS +The @code{path} refers to a file on a read-only filesystem and write access +was requested. + +@item +ELOOP +The @code{path} contains a reference to a circular symbolic link, ie a +symbolic link whose expansion contains a reference to itself. @end table @subheading DESCRIPTION: -This function dynamically allocates memory for the @code{ld}, associates -a directory path to the @code{ld}, and provides access permissions to the -@code{ld}. +This function attempts to create a file associated with the @code{logdes} +argument in the directory provided by the argument @code{path}. @subheading NOTES: -- cgit v1.2.3