adornfc(3TSOL)

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

NAME

adornfc- Adorn the final component of a pathname

SYNOPSIS

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


#include <tsol/mld.h>

int adornfc(char *path_name, char *adorned_name);

DESCRIPTION

adornfc() adorns the final component of path_name unless it is already adorned. path_name is a pathname to a filesystem object. adorned_name is a pointer to a buffer in which the adorned version of path_name is placed. This buffer should be of at least MAXPATHLEN bytes in length.

RETURN VALUES

adornfc() returns:

0

On success.

-1

On failure and sets errno to indicate the error.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

ERRORS

adornfc() 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.

EFAULT

path_name or adorned_name points to an invalid address.

EIO

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

ELOOP

Too many symbolic links were encountered in translating path_name.

ENAMETOOLONG

The length of the path argument exceeds PATH_MAX or MAXPATHLEN.

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

ENOENT

A component of the path prefix of path_name does not exist.

ENOTDIR

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

SEE ALSO

Trusted Solaris 8 Reference Manual

pathconf(2)

SunOS 5.8 Reference Manual

attributes(5)

Trusted Solaris 8  Last Revised 30 Mar 1998

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