---
name: "atopcat"
section: "1"
platform: "linux"
package: "atop"
version: "2.13.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/atopcat"
---

# atopcat(1)

concatenate raw log files to stdout

## NAME

**atopcat** - concatenate raw log files to stdout

## SYNOPSIS

**atopcat \[-dv\] rawfile \[rawfile\]...**

## DESCRIPTION

The program *atopcat* can be used to concatenate several raw log files into one stream (stdout). In this way, raw log files can be merged into one larger file by redirecting stdout to a file. Alternatively, merged data from several raw log files can be transferred directly into *atop* or *atopsar* via a pipe.

Options:

- **-d**

  dry-run: read logfile(s) but do not generate output on stdout

- **-v**

  verbose: print one line per sample containing date/time, interval length in seconds, compressed length of the system-level information, compressed length of the process-level information, compressed length of the cgroup-level information, and compressed length of the PID list.

## EXAMPLES

Concatenate the raw log files of five contiguous working days, write it into a new raw log file for that week and view that week interactively:

- **atopcat /var/log/atop/atop\_2024021\[0-4\] \> week\_2024\_7**

  - **atop -r week\_2024\_7**

  Concatenate the raw log files of a week and view that week interactively (since *atop* reads from a pipe, previous intervals can not be retrieved while viewing):

- **atopcat /var/log/atop/atop\_2024021\[0-6\] \| atop -r -**

  Concatenate all raw log files of January 2024 and generate parsable output about the CPU utilization:

- **atopcat /var/log/atop/atop\_202401?? \| atop -r - -PCPU**

  Concatenate the daily raw log files of February 3 and 4, and generate a report about memory utilization from 14:00h on the first day till 11:00h on the second day:

- **atopcat /var/log/atop/atop\_2024020\[34\] \|**

    **atopsar -m -r - -b 202402031400 -e 202402041100**

Repair a raw log file from which the last interval has not been completely written (e.g. if you intend to expand the file with new samples):

- **atopcat /var/log/atop/atop\_20240303 \> /tmp/repaired**

  In the latter case, **atopcat** reports that the input file is incomplete and stops after the last consistent sample.

## SEE ALSO

**[atop(1)](/atop/1.md),** **[atopsar(1)](/atopsar/1.md),** **[atophide(1)](/atophide/1.md),** **[atopconvert(1)](/atopconvert/1.md)**\
 **https://www.atoptool.nl**

## AUTHOR

Gerlof Langeveld (gerlof.langeveld@atoptool.nl)