xref: /freebsd/contrib/libarchive/cat/bsdcat.1 (revision 7fdf597e96a02165cfe22ff357b857d5fa15ed8a)
1.\"
2.\" SPDX-License-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (c) 2011-2014, Mike Kazantsev
5.\" All rights reserved.
6.\"
7.Dd March 1, 2014
8.Dt BSDCAT 1
9.Os
10.Sh NAME
11.Nm bsdcat
12.Nd expand files to standard output
13.Sh SYNOPSIS
14.Nm
15.Op options
16.Op files
17.Sh DESCRIPTION
18.Nm
19expands files to standard output.
20.Sh OPTIONS
21.Nm
22typically takes a filename as an argument or reads standard input when used in a
23pipe.
24In both cases decompressed data is written to standard output.
25.Sh EXAMPLES
26To decompress a file:
27.Pp
28.Dl bsdcat example.txt.gz > example.txt
29.Pp
30To decompress standard input in a pipe:
31.Pp
32.Dl cat example.txt.gz | bsdcat > example.txt
33.Pp
34Both examples achieve the same results - a decompressed file by redirecting
35output.
36.Sh SEE ALSO
37.Xr bzcat 1 ,
38.Xr uncompress 1 ,
39.Xr xzcat 1 ,
40.Xr zcat 1 ,
41.Xr libarchive-formats 5
42