.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "OPKG-BUILD 1"
.TH OPKG-BUILD 1 2023-12-01 "" "opkg-utils Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
opkg\-build \- construct an .opk from a directory
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBopkg-build\fR [\fB\-A\fR] [\fB\-X\fR] [\fB\-c\fR] [\fB\-C\fR] [\fB\-Z\fR \fIcompressor\fR] [\fB\-a\fR] [\fB\-O\fR] [\fB\-o\fR \fIowner\fR] [\fB\-g\fR \fIgroup\fR] \fIpkg_directory\fR [\fIdestination_directory\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBopkg-build\fR creates an opkg package from a filesystem tree stored in \fIpkg_directory\fR. \fIpkg_directory\fR must have a \fBCONTROL\fR directory, which contains the control information files, including the control file itself. This directory will \fInot\fR appear in the binary package's filesystem archive, but instead the files in it will be put in the binary package's control information area.
.PP
\&\fBopkg-build\fR will read \fBCONTROL/control\fR file and parse it. It will check it for syntax errors and other problems, and it will stop if it finds any.
.PP
If no \fIdestination_directory\fR is specified, \fBopkg-build\fR will write the package into a file in the current directory. The name of the package file will be \fIpackage\fR\fB_\fR\fIversion\fR\fB_\fR\fIarch\fR\fB.ipk\fR.
.PP
If the archive to be created already exists, it will be overwritten.
.SH OPTIONS
.IX Header "OPTIONS"
A summary of options is included below.
.IP \fB\-c\fR 4
.IX Item "-c"
Generate a binary package in an older \fBtar\fR format.
.IP \fB\-C\fR 4
.IX Item "-C"
Stop with an error if any files ending with \fB~\fR are found. The default behaviour is to remove such files.
.IP "\fB\-Z\fR \fIcompressor\fR" 4
.IX Item "-Z compressor"
Specify which compression type to use when building a package. Allowed values are \fBgzip\fR, \fBpigz\fR, \fBbzip2\fR, \fBlz4\fR, \fBxz\fR and \fBzstd\fR (default is \fBgzip\fR).
.IP "\fB\-a\fR \fIcompressor-args\fR" 4
.IX Item "-a compressor-args"
Specify the arguments used by the compressor. Overrides the default values.
.IP \fB\-O\fR 4
.IX Item "-O"
Use \fB.opk\fR extension. By default, \fB.ipk\fR is used.
.IP "\fB\-o\fR \fIowner\fR" 4
.IX Item "-o owner"
Force \fIowner\fR as the owner of all files in the package.
.IP "\fB\-g\fR \fIgroup\fR" 4
.IX Item "-g group"
Force \fIgroup\fR as the group of all files in the package.
.SH FILES
.IX Header "FILES"
\&\fBopkg-build\fR creates a temporary directory named \fBIPKG_BUILD.\fR\fI$$\fR in the destination directory (where \fI$$\fR stands for the PID of the running \fBopkg-build\fR). There currently isn't a way to override this.
.PP
For compatibility with Debian's \fBdpkg-deb\fR, the directory with control files can also be named \fBDEBIAN\fR. If both \fBDEBIAN\fR and \fBCONTROL\fR directories present, \fBCONTROL\fR takes the precedence.
.SH AUTHORS
.IX Header "AUTHORS"
This manual page was written by Andrew Shadura based on the manual page of \fBdpkg-deb\fR.