Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   23457 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

opensnoop(1m)			 USER COMMANDS			 opensnoop(1m)

NAME
       opensnoop - snoop file opens as they occur. Uses DTrace.

SYNOPSIS
       opensnoop [-a|-A|-ceghsvxZ] [-f pathname] [-n name] [-p PID]

DESCRIPTION
       opensnoop  tracks  file opens. As a process issues a file open, details
       such as UID, PID and pathname are printed out.

       The returned file descriptor is printed, a value	 of  -1	 indicates  an
       error.  This  can be useful for troubleshooting to determine if applia‐
       cions are attempting to open files that do not exist.

       Since this uses DTrace, only users with root privileges	can  run  this
       command.

OPTIONS
       -a     print all data

       -A     dump all data, space delimited

       -c     print current working directory of process

       -e     print errno value

       -g     print full command arguments

       -s     print start time, us

       -v     print start time, string

       -x     only print failed opens

       -Z     print zonename

       -f pathname
	      file pathname to snoop

       -n name
	      process name to snoop

       -p PID process ID to snoop

EXAMPLES
       Default output, print file opens by process as they occur,
	      # opensnoop

       Print human readable timestamps,
	      # opensnoop -v

       See error codes,
	      # opensnoop -e

       Snoop this file only,
	      # opensnoop -f /etc/passwd

FIELDS
       ZONE   Zone name

       UID    User ID

       PID    Process ID

       PPID   Parent Process ID

       FD     File Descriptor (-1 is error)

       ERR    errno value (see /usr/include/sys/errno.h)

       CWD    current working directory of process

       PATH   pathname for file open

       COMM   command name for the process

       ARGS   argument listing for the process

       TIME   timestamp for the open event, us

       STRTIME
	      timestamp for the open event, string

DOCUMENTATION
       See  the	 DTraceToolkit for further documentation under the Docs direc‐
       tory. The DTraceToolkit docs may include full worked examples with ver‐
       bose descriptions explaining the output.

EXIT
       opensnoop will run forever until Ctrl-C is hit.

BUGS
       occasionally the pathname for the file open cannot be read and the fol‐
       lowing error will be seen,

       dtrace: error on enabled probe ID 6 (...): invalid address

       this is normal behaviour.

AUTHOR
       Brendan Gregg [Sydney, Australia]

SEE ALSO
       dtrace(1M), truss(1)

version 1.60			 Jan 12, 2006			 opensnoop(1m)

Vote for polarhome