fdetach.3c (2010 09)

fdetach(3C) fdetach(3C)

NAME

fdetach( ) - detach a name from a STREAMS ﬁle descriptor

SYNOPSIS

#include <stropts.h>

int fdetach(const char *path);

DESCRIPTION

The fdetach() function detaches a ﬁle descriptor from a name in the ﬁle system designated by path .

path speciﬁes the path name of an existing object in the ﬁle system name space that was previously

attached (see fattach (3C)). As a result of the

fdetach() operation, the node’s status and permissions

return to the state prior to the ﬁle attaching to the node. Any later operations on path will affect only the

ﬁle system node and not the attached ﬁle.

Security Restrictions

The

fdetach() function is restricted to superusers, or users with the

OWNER privilege, or those who

own path and have write permission. In addition to having the

OWNER privilege, DACREAD or

DACWRITE privileges may also be required. See privileges (5) for more information about privileged

access on systems that support ﬁne-grained privileges.

RETURN VALUE

Upon successful completion, the

fdetach() function returns a value of 0 (zero). Otherwise, it returns a

value of -1 is returned, and errno is set to indicate the error.

ERRORS

If any of the following conditions occurs, the

fdetach() function sets errno to the value that

corresponds to the condition.

[EFAULT] The path parameter points outside the process’ allocated address space.

[EACCES] The user does not have the correct permission to access the ﬁle. See the Security

Restrictions section.

[EINVAL] The object pointed to by the path parameter is not fattached to a STREAMS dev-

ice or pipe.

[ELOOP] When path was translated, too many symbolic links were found.

[ENOENT] The path parameter points to a path name that does not exist.

[ENOTDIR] The directory portion of the path parameter does not exist.

[ENAMETOOLONG] The size of a path name component is longer than

NAME_MAX when

_POSIX_NO_TRUNC is in effect, or the path name length is longer than

PATH_MAX.

[EPERM] The current effective user ID is not the owner of the existing object speciﬁed by

the path parameter, or the current effective user ID does not specify a user with

the correct permissions.