fdetach(3C)							   fdetach(3C)

NAME    [Toc]    [Back]

     fdetach - detach a	name from a STREAMS-based file descriptor

SYNOPSIS    [Toc]    [Back]

     int fdetach(const char *path);

DESCRIPTION    [Toc]    [Back]

     The fdetach routine detaches a STREAMS-based file descriptor from a name
     in	the filesystem.	 path is the pathname of the object in the filesystem
     name space, which was previously attached (see fattach(3C)).  The user
     must be the owner of the file or a	user with the appropriate privileges.
     All subsequent operations on path will operate on the filesystem node and
     not on the	STREAMS	file.  The permissions and status of the node are
     restored to the state the node was	in before the STREAMS file was
     attached to it.

RETURN VALUE    [Toc]    [Back]

     If	successful, fdetach returns 0; otherwise it returns -1 and sets	errno
     to	indicate an error.

ERRORS    [Toc]    [Back]

     Under the following conditions, the function fdetach fails	and sets errno
     to:

     EPERM	  The effective	user ID	is not the owner of path or is not a
		  user with appropriate	permissions.

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

     ENOENT	  path does not	exist.

     EINVAL	  path is not attached to a STREAMS file.

     ENAMETOOLONG The size of path exceeds {PATH_MAX}, or a pathname component
		  is longer than {NAME_MAX} while {_POSIX_NO_TRUNC} is in
		  effect.

     ELOOP	  Too many symbolic links were encountered in translating
		  path.

SEE ALSO    [Toc]    [Back]

     fdetach(1M), fattach(3C), streamio(7)


									PPPPaaaaggggeeee 1111