fuser(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES

NAME

fuser– Identify processes using a file or file structure

SYNOPSIS

/usr/sbin/fuser [- [c| f]ku] files [[- [c| f]ku]files] …

DESCRIPTION

fuser displays the process IDs of the processes that are using the files specified as arguments.

Each process ID is followed by a letter code. These letter codes are interpreted as follows: if the process is using the file as

c

Indicates that the process is using the file as its current directory.

m

Indicates that the process is using a file mapped with mmap(). See mmap(2) for details.

o

Indicates that the process is using the file as an open file.

r

Indicates that the process is using the file as its root directory.

t

Indicates that the process is using the file as its text file.

y

Indicates that the process is using the file as its controlling terminal.

For block special devices with mounted file systems, all processes using any file on that device are listed. For all types of files (text files, executables, directories, devices, and so forth), only the processes using that file are reported.

If more than one group of files are specified, the options may be respecified for each additional group of files. A lone dash cancels the options currently in force.

The process IDs are printed as a single line on the standard output, separated by spaces and terminated with a single new line. All other output is written on standard error.

To succeed, this command requires the sys_mount privilege. Any user with permission to read /dev/kmem and /dev/mem can use fuser.

OPTIONS

The following options are supported:

-c

Reports on files that are mount points for file systems, and any files within that mounted file system.

-f

Print a report for the named file, not for files within a mounted file system.

-k

Sends the SIGKILL signal to each process. Since this option spawns kills for each process, the kill messages may not show up immediately. (See kill(2)). The -k option requires the sys_mount and proc_owner privileges if it is to terminate another user's process.

-u

Displays the user login name in parentheses following the process ID.

ENVIRONMENT VARIABLES

See environ(5) for descriptions of the following environment variables that affect the execution of fuser: LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, and NLSPATH.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SUMMARY OF TRUSTED SOLARIS CHANGES

To succeed, this command requires the sys_mount privilege. With the -k option, the command also needs the proc_owner privilege to terminate another user's process.

SEE ALSO

Trusted Solaris 8 HW 12/02 Reference Manual

mount(1M), kill(2)

SunOS 5.8 Reference Manual

ps(1), signal(3C), attributes(5)

NOTES

Because fuser works with a snapshot of the system image, it may miss processes that begin using a file while fuser is running. Also, processes reported as using a file may have stopped using it while fuser was running. These factors should discourage the use of the -k option.

SunOS 5.8  Last Revised 12 Feb 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES