cat.1 (1215B)
- .\" utils-std: Collection of commonly available Unix tools
- .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
- .\" SPDX-License-Identifier: MPL-2.0
- .Dd 2022-02-13
- .Dt CAT 1
- .Os
- .Sh NAME
- .Nm cat
- .Nd concatenate files
- .Sh SYNOPSIS
- .Nm
- .Op Fl u
- .Op Ar file...
- .Sh DESCRIPTION
- .Nm
- reads each
- .Ar file
- in sequence and writes it on the standard output.
- If no
- .Ar file
- is given,
- .Nm
- reads from the standard input.
- .Sh OPTIONS
- The
- .Fl u
- option is ignored, present only for POSIX compatibility.
- .Sh EXIT STATUS
- .Ex -std
- .Sh EXAMPLES
- .Bl -tag -width Ds
- .It Ql cat file1 - file2 - file3
- Print the contents of
- .Ar file1 ;
- then copy standard input until EOF (^D) is received;
- then print the contents of
- .Ar file2 ;
- then the rest of standard input until EOF (^D) is received again;
- finally
- .Nm
- will print the contents of
- .Ar file3 .
- Note that when standard input refers to a file, the second dash
- does nothing as there isn't any remaining data to print.
- .It Ql time cat
- Get a stopwatch utility which stops once EOF is pressed.
- .El
- .Sh STANDARDS
- .Nm
- is mostly compliant with the
- IEEE Std 1003.1-2024 (“POSIX.1”)
- specification.
- .Sh AUTHORS
- .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me