.\"
.\" Copyright (c) 2008-2024 Jonathan Schleifer <js@nil.im>
.\"
.\" All rights reserved.
.\"
.\" This program is free software: you can redistribute it and/or modify it
.\" under the terms of the GNU Lesser General Public License version 3.0 only,
.\" as published by the Free Software Foundation.
.\"
.\" This program is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
.\" version 3.0 for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public License
.\" version 3.0 along with this program. If not, see
.\" <https://www.gnu.org/licenses/>.
.\"
.TH ofarc 1
.SH NAME
ofarc - list, extract, create and append to archives
.SH SYNOPSIS
.B ofarc
[\fBoptions\fR] \fIarchive\fR [\fIfile1\fR \fIfile2\fR ...]
.SH DESCRIPTION
.B ofarc
is a program to list, extract, create and append to archives.
.SH OPTIONS
.TP
.BR \fB\-a\fR ", " \fB\-\-append\fR
Append to archive.
.TP
.BR \fB\-\-archive\-comment=\fIcomment\fR
Archive comment to use when creating or appending.
.TP
.BR \fB\-c\fR ", " \fB\-\-create\fR
Create archive.
.TP
.BR \fB\-C\fR " " \fIdirectory\fR ", " \fB\-\-directory=\fIdirectory\fR
Extract into the specified directory.
.TP
.BR \fB\-E\fR " " \fIencoding\fR ", " \fB\-\-encoding=\fIencoding\fR
The encoding used by the archive (only tar, lha and zoo files).
.TP
.BR \fB\-f\fR ", " \fB\-\-force\fR
Force / overwrite files.
.TP
.BR \fB\-h\fR ", " \fB\-\-help\fR
Show the help.
.TP
.BR \fB\-\-iri\fR
Use an IRI to access the archive.
.TP
.BR \fB\-l\fR ", " \fB\-\-list\fR
List all files in the archive.
.TP
.BR \fB\-n\fR ", " \fB\-\-no\-clobber\fR
Never overwrite files.
.TP
.BR \fB\-p\fR ", " \fB\-\-print\fR
Print one or more files from the archive.
.TP
.BR \fB\-q\fR ", " \fB\-\-quiet\fR
Quiet mode (no outputu, except errors).
.TP
.BR \fB\-t\fR " " \fItype\fR ", " \fB\-\-type=\fItype\fR
Archive type (gz, lha, tar, tgz, zip, zoo).
.TP
.BR \fB\-v\fR ", " \fB\-\-verbose\fR
Verbose output for file list.
.TP
.BR \fB\-x\fR ", " \fB\-\-extract\fR
Extract files.
.SH EXAMPLES
Extract all files in an archive:
.PP
ofarc -x archive.tar.gz
.PP
Create a new archive with the directory \fBfoo\fR and all its files:
.PP
ofarc -c foo.zip foo
.PP
List all files in an archive without downloading it:
.PP
ofarc --iri -l https://example.com/archive.lha
.PP
Print file \fBREADME\fR in \fBarchive.tar.gz\fR:
.PP
ofarc -p archive.tar.gz README