ATOPCAT(1) General Commands Manual ATOPCAT(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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**](#d)

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

[**-v**](#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](#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](#SEE_ALSO)

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

# [AUTHOR](#AUTHOR)

Gerlof Langeveld (gerlof.langeveld@atoptool.nl)

January 2024 Linux

---

Document: atopcat(1) from atop 2.13.0-r2 (Chainguard OS)
Source: https://github.com/Atoptool/atop