fuser(8)fuser(8)NAMEfuser - 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)