RTEMS Logo

RTEMS 4.6.2 On-Line Library


Event Logging Manager log_create - Creates a log file

PREV UP NEXT Bookshelf New Chapters

1.4.16: log_create - Creates a log file

CALLING SEQUENCE:

#include <evlog.h>

int log_create(
  logd_t       *ld,
  const char   *path,
);

STATUS CODES:

A successful call to log_create() returns a value of zero and a unsuccessful call returns the errno.

EEXIST
The path already exists and O_CREAT and O_EXCL were used.
EISDIR
The path refers to a directory and the access requested involved writing.
ETXTBSY
The path refers to an executable image which is currently being executed and write access was requested.
EFAULT
The path points outside your accessible address space.
EACCES
The requested access to the file is not allowed, or one of the directories in path did not allow search (execute) permission.
ENAMETOOLONG
The path was too long.
ENOENT
A directory component in path does not exist or is a dangling symbolic link.
ENOTDIR
A component used as a directory in path is not, in fact, a directory.
EMFILE
The process already has the maximum number of files open.
ENFILE
The limit on the total number of files open on the system has been reached.
ENOMEM
Insufficient kernel memory was available.
EROFS
The path refers to a file on a read-only filesystem and write access was requested.
ELOOP
The path contains a reference to a circular symbolic link, ie a symbolic link whose expansion contains a reference to itself.

DESCRIPTION:

This function attempts to create a file associated with the logdes argument in the directory provided by the argument path.

NOTES:

The _POSIX_LOGGING feature flag is defined to indicate this service is available.


PREV UP NEXT Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation