RTEMS Logo

RTEMS 4.6.0 On-Line Library


Configuration Space Manager cfg_mount - Mount a Configuration Space

PREV UP NEXT Bookshelf New Chapters

3.4.1: cfg_mount - Mount a Configuration Space

CALLING SEQUENCE:

#include <cfg.h>

int cfg_mount(
  const char     *file,
  const char     *cfgpath,
  log_facility_t  notification,
);

STATUS CODES:

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

EPERM
The caller does not have the appropriate privilege.
EACCES
Search permission is denied for a component of the path prefix.
EEXIST
The file specified by the file argument does not exist
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.
ENOENT
A component of cfgpath does not exist.
ENOTDIR
A component of the file path prefix is not a directory.
EBUSY
The configuration space defined by file is already mounted.
EINVAL
The notification argument specifies an invalid log facility.

DESCRIPTION:

The cfg_mount() function maps a configuration space defined by the file identified by the the file argument. The distinguished node of the mapped configuration space is mounted in the active space at the point identified by the cfgpath configuration pathname.

The notification argument specifies how changes to the mapped configuration space are communicated to the application. If the notification argument is NULL, no notification will be be performed for the mapped configuration space. If the Event Logging option is defined, the notification argument defines the facility to which changes in the mapped configuration space are logged. Otherwise, the notification argument specifies an implementation defined method of notifying the application of changes to the mapped configuration space.

NOTES:

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


PREV UP NEXT Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation