---
name: "perf_2.6.32-record"
section: "1"
platform: "linux"
package: "linux-tools-2.6.32"
version: "2.6.32-48squeeze6"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/perf_2.6.32-record"
---

# perf\_2.6.32-record(1)

Run a command and record its profile into perf.data

## NAME

perf-record - Run a command and record its profile into perf.data

## SYNOPSIS

```
perf record [-e <EVENT> | --event=EVENT] [-l] [-a] <command>
perf record [-e <EVENT> | --event=EVENT] [-l] [-a] — <command> [<options>]
```

## DESCRIPTION

This command runs a command and gathers a performance counter profile from it, into perf.data - without displaying anything.

This file can then be inspected later on, using *perf report*.

## OPTIONS

\<command\>...

Any command you can specify in a shell.

\-e, --event=

Select the PMU event. Selection can be a symbolic event name (use *perf list* to list all events) or a raw PMU event (eventsel+umask) in the form of rNNN where NNN is a hexadecimal event descriptor.

- \-a

  System-wide collection.

- \-l

  Scale counter values.

\-p, --pid=

Record events on existing pid.

\-r, --realtime=

Collect data with this RT SCHED\_FIFO priority.

- \-A, --append

  Append to the output file to do incremental profiling.

- \-f, --force

  Overwrite existing data file.

\-c, --count=

Event period to sample.

\-o, --output=

Output file name.

- \-i, --inherit

  Child tasks inherit counters.

\-F, --freq=

Profile at this frequency.

\-m, --mmap-pages=

Number of mmap data pages.

- \-g, --call-graph

  Do call-graph (stack chain/backtrace) recording.

- \-v, --verbose

  Be more verbose (show counter open errors, etc).

- \-s, --stat

  Per thread counts.

- \-d, --data

  Sample addresses.

- \-n, --no-samples

  Don’t sample.

- \-R, --raw-samples

  Collect raw sample records from all opened counters (typically for tracepoint counters).

## SEE ALSO

[**perf\_2.6.32-stat**(1)](/perf_2.6.32-stat/1.md), [**perf\_2.6.32-list**(1)](/perf_2.6.32-list/1.md)