fuser man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

fuser(8)							      fuser(8)

NAME
       fuser - Lists process IDs of processes that are using one or more files
       or file structures

SYNOPSIS
       /usr/sbin/fuser [-cfu]  file...

       [Tru64 UNIX]  The following format shows extensions not included in the
       XCU  specification  for	this utility: /usr/sbin/fuser [ -acdfku] [ -h]
       [-vH ] file ...

STANDARDS
       Interfaces documented on this reference page conform to industry	 stan‐
       dards as follows:

       fuser: XCU5.0

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

OPTIONS
       [Tru64 UNIX]  In a TruCluster Server cluster,  directs  fuser  to  list
       processes  running  on  any cluster member.  Identifies file as a mount
       point. In this case, fuser reports on any files that are	 open  in  the
       mounted	file  system.	Reports	 any  referenced  files that have been
       deleted including the referencing PID and the block count for the  file
       in  512	byte  block  units.   Requests a report only for the specified
       files. If a specified file is a mount point, fuser reports only on that
       file,  not  on  any  files  below it.  [Tru64 UNIX]   Suppresses column
       headings in  fuser  output  when	 used  with  the  -v  option.	[Tru64
       UNIX]  Directs  fuser  to  display  information	about its command-line
       options.	 [Tru64 UNIX]  Directs fuser to send a SIGKILL signal to  each
       corresponding  process. The kill messages might not show up immediately
       because the signals operate asynchronously.  Directs fuser to show  the
       user  login  name,  in  parentheses,  associated	 with each process ID.
       [Tru64 UNIX]  Directs fuser to display results in verbose form.

PARAMETERS
       [Tru64 UNIX]  Directs fuser to ignore previous option settings for  the
       next  set of file parameters. The - operand allows you to apply differ‐
       ent options to different sets of files in the same command line.	 Spec‐
       ifies the pathname of the file or the mount point of the file system on
       which fuser reports.

DESCRIPTION
       The fuser utility writes to standard output the	process	 IDs  of  pro‐
       cesses that are running on the local system (or, if -a is specified, on
       any cluster member) and which have one or more files or file structures
       in  use.	 The  utility  writes to standard error additional information
       about these resources that indicates how each resource is being used.

       The fuser utility reports on processes that reference the file  parame‐
       ter. When run with root privilege, fuser reports on all processes. Oth‐
       erwise, running fuser reports only on those processes with  a  matching
       effective UID or real UID.

       The  utility uses the following format to write the process ID for each
       process using each file:

       "%d", process_id

       The fuser utility writes diagnostic messages to standard error.

       In addition, the utility writes the following information  to  standard
       error: The pathname of each file, immediately followed by a colon.  For
       each process ID written to standard output, one of the following	 char‐
       acters:	If  the	 process  is  using the file as its current directory.
       [Tru64 UNIX]  If the process is using  a	 memory-mapped	file.	[Tru64
       UNIX]  If  the  process	is using the file as the parent of its current
       directory.  If the process is using the file  as	 its  root  directory.
       [Tru64  UNIX]  If  the process has the file open.  [Tru64 UNIX]	If the
       process is using the file as its controlling tty.  [Tru64 UNIX]	If the
       process is using the text file as an executable.

	      If  you  specify the -u option, characters indicating the use of
	      the file are followed immediately by the user name, in parenthe‐
	      ses, that corresponds to the process's real user ID. If the user
	      name cannot be resolved from the process's  real	user  ID,  the
	      process's real user ID is written instead of the user name.

       When  standard output and standard error are directed to the same file,
       the utility intersperses output so that the file appears at  the	 start
       of  each line, followed by the process ID and the characters indicating
       file use. Then, if the -u option is specified, the utility  writes  the
       user  name  or  user  ID	 for each process that is using that file. The
       utility writes a newline character at the end of output for each file.

NOTES
       [Tru64 UNIX]  The fuser utility may not report on processes that	 begin
       using  a file while the utility is running. Furthermore, processes that
       fuser reports are using a file may have	stopped	 using	it  while  the
       utility was running.

       If  an  accounting  file	 has  been opened by an acct() sytem call, the
       fuser command and system call will report any match as  being  open  by
       the kernel task.

EXIT STATUS
       The fuser utility returns the following exit values: Successful comple‐
       tion.  An error occurred.

EXAMPLES
       The following command lists the process	IDs  of	 processes  using  the
       /etc/hosts file: fuser /etc/hosts The following command writes to stan‐
       dard output the process IDs of processes that  are  using  the  current
       directory.  The	command	 writes to standard error an indication of how
       those processes are using the directory and the user  names  associated
       with those processes.  fuser -fu.

ENVIRONMENT VARIABLES
       The  following  environment  variables  affect this utility: Provides a
       default value for the locale variables that are unset or null. If  LANG
       is  unset or null, the corresponding value from the POSIX (C) locale is
       used.  If any of the locale variables contain an invalid	 setting,  the
       utility	behaves as if none of the variables had been set.  If set to a
       non-empty string value, overrides the values of all  the	 other	locale
       variables.   Specifies  the locale used to interpret sequences of bytes
       of text data as characters (for example, determines  whether  arguments
       contain	single-byte  or	 multibyte  characters).  Specifies the locale
       that affects the format and contents of diagnostic messages written  to
       standard	 error.	  Determines  the location of message catalogs for the
       processing of LC_MESSAGES.

SEE ALSO
       Functions: fuser(2), kill(2)

								      fuser(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net