cd_defs(3X)
cd_defs --
set or get default CD-ROM file permissions, user IDs, and group IDs
Synopsis
cc [flag . . . ] file . . . -lcdfs -lgen [library] . . .
#include <sys/cdrom.h>
int cd_defs(const char *path, int cmd, struct cd_defs *defs);
Description
cd_defs sets or gets the default values of CD-ROM file
permissions, directory permissions, user IDs and group IDs.
If files or directories do not have permissions, user IDs, or group IDs
specified, the system provides default values.
cd_defs will modify these values for a mounted file system.
cd_defs also allows you to change the definition of
search permissions for directories.
cd_defs should be invoked after
mounting the CD-ROM, but before opening any files.
Permissions that are changed while a file is
open will not take effect until the file is closed.
- path
-
Mount point of the CD-ROM file system.
- cmd
-
CD_GETDEFS to get values or CD_SETDEFS to set values.
- defs
-
Pointer to the cd_defs structure that contains
values to be set (CD_SETDEFS) or to be filled in with
current values (CD_GETDEFS).
Return values
On success, cd_defs returns a value of zero.
On failure, cd_defs returns -1 and sets
errno to identify the error as follows:
- EACCES
-
Read permission is denied on the mount point, or
search permission is denied on a component of path.
- EFAULT
-
Invalid address for the structure defs or path.
- EINTR
-
A signal was caught during the execution of cd_defs.
- EINVAL
-
The path argument does not point to
a valid mount point, or the value of cmd is invalid,
or a member of the cd_defs structure contains an invalid value.
- EMFILE
-
The maximum number of file descriptors are open.
- ENAMETOOLONG
-
The size of path exceeds MAXPATHLEN, or the component of a
path name is longer than MAXNAMELEN while _POSIX_NO_TRUNC
is in effect.
- ENFILE
-
The system file table is full.
- ENOENT
-
path does not exist or the path argument points to an
empty string.
- ENOTDIR
-
A component of path is not a directory.
- EPERM
-
User lacks write permission to set values.
References
cdmntsuppl(1M),
cdfs-specific
fs_cdfs(4),
mount(1M)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.