CD_NMCONV Domain/OS CD_NMCONV
NAME
cd_nmconv - set and get CD-ROM file name conversion
SYNTAX
#include <sys/cdrom.h>
int cd_nmconv(path, cmd, flag)
char *path;
int cmd;
int *flag;
DESCRIPTION
This function sets or gets (based upon cmd) the name conversion flag for
file names on the mounted CD-ROM. The argument path points to a mount-
point of a CD-ROM file system. The argument cmd is either CD_SETNMCONV or
CD_GETNMCONV. The parameter flag is one of the following:
CD_NOCONV: no conversion (default after mounting of the CD-ROM).
CD_LOWER: Characters in Identifiers on CD-ROM are converted to lowercase
when represented in the XSI file hierarchy. If a File Identifier contains
no File Name Extension, the SEPARATOR 1 (".") is not represented.
CD_NOVERSION: The Version Number and the SEPARATOR 2 (";") of a File
Identifier is not represented in the XSI file hierarchy.
CD_LOWER and CD_NOVERSION may be bitwise-inclusive or-ed.
RETURN VALUE
Upon successful completion, cd_nmconv returns a value of zero. In case
of an error, -1 is returned and errno is set to indicate the error.
ERRORS
The cd_nmconv function will fail if one or more of the following is true:
[EACCESS]
Search permission is denied for a component of the path
prefix. Read permission is denied on the mount-point.
[ENAMETOOLONG]
The length of the path string exceeds {PATH_MAX} or a
pathname component is longer than {NAME_MAX} while
{_POSIX_NO_TRUNC} is in effect.
[ENOENT]
A component of path does not exist or the path
argument points to an empty string.
[EINVAL]
The value of cmd or flag is invalid.
The argument path points to a file/directory not within
a CD-ROM file hierarchy.
[ENOTDIR]
A component of the path prefix is not a directory.
[EFAULT]
The address of lag or path is invalid.
[EPERM]
User does not have appropriate privileges to
set values.
[EINTR]
A signal was caught during the cd_nmconv() function.
[EMFILE]
{OPEN_MAX} file descriptors are currently open in the
calling process.
[ENFILE]
The system file table is full.
APPLICATION USAGE
The setting of values is restricted to a user with appropriate
privileges. In case of setting file name conversion this function is
intended to be used only directly after the CD-ROM has been mounted, and
before any access to the CD-ROM is done. If the function is applied for
setting mappings when files or directories have already been opened the
effect of this function on these files and directories is undefined.