getmldadorn(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | WARNINGS | SEE ALSO

NAME

getmldadorn, fgetmldadorn- Get file system multilevel directory adornment

SYNOPSIS

cc [flags...] file... -ltsol


#include <tsol/mld.h>

int getmldadorn(char *path_name, char adorn_buf[MLD_ADORN_MAX]);
int fgetmldadorn(intfd, char adorn_buf[MLD_ADORN_MAX]);

DESCRIPTION

getmldadorn() returns the MLD adornment of the file system on which path_name resides. path_name is the path name of any file within the mounted filesystem. adorn_buf is a pointer to a buffer of at least MLD_ADORN_MAX bytes in which the null-terminated MLD adornment is returned.

fgetmldadorn() returns the same information about an open file referred to by descriptor fd.

The information label of path_name or fd is unchanged. The information label of the calling process is also unchanged.

RETURN VALUES

getmldadorn() and fgetmldadorn() return:

0

On success.

-1

On failure and set errno to indicate the error.

ERRORS

getmldadorn() fails if one or more of the following are true:

EACCES

Search permission is denied for a component of the path prefix of path_name. To override this restriction, the calling process may assert the PRIV_FILE_DAC_SEARCH privilege and/or the PRIV_FILE_MAC_SEARCH privilege.

EFAULT

adorn_buf or path_name points to an invalid address.

EIO

An I/O error occurred while reading from or writing to the file system.

ELOOP

Too many symbolic links were encountered in translating path_name.

ENAMETOOLONG

The length of the path argument exceeds PATH_MAX.

A pathname component is longer than NAME_MAX (see sysconf(3C)) while _POSIX_NO_TRUNC is in effect (see pathconf(2)).

ENOENT

The file referred to by path_name does not exist.

ENOTDIR

A component of the path prefix of path_name is not a directory.

fgetmldadorn() fails if one or more of the following are true:

EBADF

fd is not a valid open file descriptor.

EFAULT

adorn_buf points to an invalid address.

EINVAL

fd refers to a socket, not a file.

EIO

An I/O error occurred while reading from the file system.

WARNINGS

If the filesystem of the fd does not support MLDs and no mld_prefix attribute was specified at mount time, no error is returned, and a zero-length string is returned in the adorn_buf buffer.

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

fgetsldname(2), getsldname(2)

SunOS 5.8  Last Revised 30 Sep 1999

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | WARNINGS | SEE ALSO