Index for Section 3

Alphabetical listing for F

Bottom of page

fdetach(3)
NAME
  fdetach - Detaches a STREAMS-based file descriptor from a file in the file
  system name space

LIBRARY
  Standard C Library (libc.so, libc.a)

SYNOPSIS
  #include <stropts.h>
  int fdetach(
	  const char *path);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  fdetach():  XSH5.0

  Refer to standards(5) for more information about industry standards and
  associated tags.

PARAMETERS
  path	    Specifies the pathname of an existing regular file or directory.

DESCRIPTION
  The fdetach() function disassociates a STREAMS-based file descriptor from
  the file pointed to by the path parameter.  The STREAMS-based file
  descriptor was associated with the file by a prior fattach() function.

  A successful call to the fdetach() function causes all path names that
  named the attached STREAMS file to again name the file to which the STREAMS
  file was attached.  All subsequent operations on the file pointed to by the
  path parameter are performed on the underlying file and not on the STREAMS
  file.

  All open file descriptors established while the STREAMS file was attached
  to the file referenced by the path parameter still refer to the STREAMS
  file after the fdetach() function takes effect.

  If there are no open file descriptors or other references to the STREAMS
  file when a fdetach() function is called, a successful call has the same
  effect as performing the last close call on the attached file.

  The detach() function uses the File-on-File Mounting (FFM) file system.
  Instead of unmounting a file system on a mount point, the detach() function
  FFM unmounts a file descriptor from a mount point, which can be either a
  directory or a regular file.	See ffm(4).

RETURN VALUES
  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.

  [EACCES]  The user is not the owner of the file or does not have the
	    correct permissions to access the file.

  [EBUSY]   [Tru64 UNIX]  There is an active reference to a file located on
	    the file system.

  [EFAULT]  [Tru64 UNIX]  The path parameter points outside the process's
	    allocated address space.

  [EINVAL]  The path parameter names a file that is not currently attached.

  [ELOOP]   Too many symbolic links were found when path was resolved.

  [ENOENT]  An element of the path parameter does not name an existing file
	    or path is an empty string.

  [ENOTDIR] An element of the directory portion of the path parameter is not
	    a directory.

  [ENAMETOOLONG]
	    [Tru64 UNIX]  The size of a pathname component is longer than
	    NAME_MAX when _POSIX_NO_TRUNC is in effect.

	    The pathname length is longer than [PATH_MAX], or the length of
	    the intermediate result of a pathname resolution of a symbolic
	    link is longer than PATH_MAX.

  [EPERM]   The effective user ID is not the owner of the file pointed to by
	    thepath parameter or does not specify a user with the correct
	    privileges.

RESTRICTIONS
  [Tru64 UNIX]	The fdetach() function requires that the FFM_FS kernel option
  be configured.  See System Administration for information on configuring
  kernel options.

RELATED INFORMATION
  Functions: fattach(3), isastream(3), umount(3)

  Commands: fdetach(8)

  Interfaces: streamio(7)

  Standards: standards(5)

Index for Section 3

Alphabetical listing for F

Top of page