---
name: "spfdsnoop-bpfcc"
section: "8"
platform: "linux"
package: "bpfcc-tools"
version: "0.31.0+ds-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/spfdsnoop-bpfcc"
---

# spfdsnoop-bpfcc(8)

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

## 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

## SEE ALSO

opensnoop(1)