FDETACH(3C-SVR4)    RISC/os Reference Manual     FDETACH(3C-SVR4)



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 {PATH_MAX}, or a path
                  name 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
     fdetach(1M), fattach(3C), streamio(7).
     STREAMS Programmer's Guide.










                        Printed 11/19/92                   Page 1