getlabel(2) [opensolaris man page]

getlabel(2)							   System Calls 						       getlabel(2)

NAME

       getlabel, fgetlabel - get file sensitivity label

SYNOPSIS

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

       #include <tsol/label.h>

       int getlabel(const char *path, m_label_t *label_p);

       int fgetlabel(int fd, m_label_t *label_p);

DESCRIPTION

       The getlabel() function obtains the sensitivity label of the file that is named by path. Discretionary read, write or execute permission to
       the final component of path is not required, but all directories in the path prefix of path must be searchable.

       The fgetlabel() function obtains the label of an open file that is referred to by the argument descriptor, such as would be obtained by	an
       open(2) call.

       The label_p argument is a pointer to an opaque label structure. The caller must allocate space for label_p by using m_label_alloc(3TSOL).

RETURN VALUES

       Upon successful completion, getlabel() and fgetlabel() return 0. Otherwise they return -1 and set errno to indicate the error.

ERRORS

       The getlabel() function will fail if:

       EACCES	       Search  permission  is denied for a component of the path prefix of path. To override this restriction, the calling process
		       can assert the PRIV_FILE_DAC_SEARCH privilege.

       EFAULT	       label_p or path 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.

       ENAMETOOLONG    The length of the path argument exceeds PATH_MAX, or a pathname component is longer than NAME_MAX while _POSIX_NO_TRUNC	is
		       in effect (see pathconf(2)).

       ENOENT	       The file referred to by path does not exist.

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

       The fgetlabel() function will fail if:

       EBADF	 The fd argument is not a valid open file descriptor.

       EFAULT	 The label_p argument points to an invalid address.

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcslr			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       open(2), pathconf(2), m_label_alloc(3TSOL), attributes(5), labels(5)

       Obtaining a File Label in Solaris Trusted Extensions Developer's Guide

NOTES

       The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

SunOS 5.11							    20 Jul 2007 						       getlabel(2)

chdir(2)							   System Calls 							  chdir(2)

NAME

       chdir, fchdir - change working directory

SYNOPSIS

       #include <unistd.h>

       int chdir(const char *path);

       int fchdir(int fildes);

DESCRIPTION

       The  chdir()  and  fchdir() functions cause a directory pointed to by path or fildes to become the current working directory.  The starting
       point for path searches for path names not beginning with / (slash). The path argument points to the path name of a directory.  The  fildes
       argument is an open file descriptor of a directory.

       For a directory to become the current directory, a process must have execute (search) access to the directory.

RETURN VALUES

       Upon successful completion, 0 is returned. Otherwise, -1 is returned, the current working directory is unchanged, and errno is set to indi-
       cate the error.

ERRORS

       The chdir() function will fail if:

       EACCES	       Search permission is denied for any component of the path name.

       EFAULT	       The path argument points to an illegal address.

       EINTR	       A signal was caught during the execution of the chdir() function.

       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.

       ENAMETOOLONG    The length of the path argument exceeds PATH_MAX, or the length of a path component exceeds NAME_MAX while  _POSIX_NO_TRUNC
		       is in effect.

       ENOENT	       Either a component of the path prefix or the directory named by path does not exist or is a null pathname.

       ENOLINK	       The path argument points to a remote machine and the link to that machine is no longer active.

       ENOTDIR	       A component of the path name is not a directory.

       The fchdir() function will fail if:

       EACCES	  Search permission is denied for fildes.

       EBADF	  The fildes argument is not an open file descriptor.

       EINTR	  A signal was caught during the execution of the fchdir() function.

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

       ENOLINK	  The fildes argument points to a remote machine and the link to that machine is no longer active.

       ENOTDIR	  The open file descriptor fildes does not refer to a directory.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       chroot(2), attributes(5), standards(5)

SunOS 5.11							    28 Dec 1996 							  chdir(2)