fdetach(3C)             LIBRARY FUNCTIONS             fdetach(3C)



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

SYNOPSIS
     int fdetach(const char *path);

DESCRIPTION
     The fdetach routine detaches a STREAMS-based file descriptor
     from  a  name  in the file system.  path is the path name of
     the object in the file system name space, which  was  previ-
     ously 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 file sys-
     tem 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
     If successful, fdetach returns 0; otherwise  it  returns  -1
     and sets errno to indicate an error.

ERRORS
     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  direc-
                  tory.

     ENOENT       path does not exist.

     EINVAL       path is not attached to a STREAMS file.

     ENAMETOOLONG The size of path exceeds {PATHMAX}, or a  path
                  name  component is longer than {NAMEMAX} while
                  {POSIXNOTRUNC} is in effect.

     ELOOP        Too many symbolic  links  were  encountered  in
                  translating path.

SEE ALSO
     fdetach(1M), fattach(3C), streamio(7).
     in the Programmer's Guide: STREAMS










                                                                1