Section 8 · System administration

bcc-spfdsnoop.8

Package: bcc-tools

On this page

sofdsnoop

NAME
SYNOPSIS
DESCRIPTION
REQUIREMENTS
OPTIONS
EXAMPLES
FIELDS
SOURCE
OS
STABILITY
AUTHOR
SEE ALSO

NAME

sofdsnoop − Trace FDs passed through unix sockets. Uses Linux eBPF/bcc.

SYNOPSIS

sofdsnoop [-h] [-T] [-p PID] [-t TID] [-n NAME] [-d DURATION]

DESCRIPTION

sofdsnoop traces FDs passed through unix sockets

Every file descriptor that is passed via unix sockets os displayed on separate line together with process info (TID/COMM columns), ACTION details (SEND/RECV), file descriptor number (FD) and its translation to file if available (NAME).

Since this uses BPF, only the root user can use this tool.

REQUIREMENTS

CONFIG_BPF and bcc.

OPTIONS


	−h		Print usage message.
	−T		Include a timestamp column.
	−p PID		Trace this process ID only (filtered in-kernel).
	−t TID		Trace this thread ID only (filtered in-kernel).

−d DURATION

Total duration of trace in seconds.

−n NAME

Only print command lines matching this command name (regex)

EXAMPLES

Trace all sockets:

sofdsnoop

Trace all sockets, and include timestamps:

sofdsnoop −T

Only trace sockets where the process contains “server”:

sofdsnoop −n server

FIELDS

TIME(s)

Time of SEDN/RECV actions, in seconds.


	ACTION		Operation on the fd SEND/RECV.
	TID		Process TID
	COMM		Parent process/command name.
	SOCKET		The socket carrier.
	FD		file descriptor number
	NAME		file name for SEND lines

SOURCE

This is from bcc.

https://github.com/iovisor/bcc

Also look in the bcc distribution for a companion _examples.txt file containing example usage, output, and commentary for this tool.

OS

Linux

STABILITY

Unstable - in development.

AUTHOR

Jiri Olsa