~ubuntu-branches/ubuntu/trusty/apt/trusty

'\" t

.\"     Title: apt-sortpkgs

.\"    Author: Jason Gunthorpe

.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>

.\"      Date: 09\ \&June\ \&2012

.\"    Manual: APT

.\"    Source: APT 1.0

.\"  Language: English

.\"

.TH "APT\-SORTPKGS" "1" "09\ \&June\ \&2012" "APT 1.0" "APT"

.\" -----------------------------------------------------------------

.\" * Define some portability stuff

.\" -----------------------------------------------------------------

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.\" http://bugs.debian.org/507673

.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html

.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\" -----------------------------------------------------------------

.\" * set default formatting

.\" -----------------------------------------------------------------

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.\" -----------------------------------------------------------------

.\" * MAIN CONTENT STARTS HERE *

.\" -----------------------------------------------------------------

.SH "NAME"

apt-sortpkgs \- Utility to sort package index files

.SH "SYNOPSIS"

.HP \w'\fBapt\-sortpkgs\fR\ 'u

\fBapt\-sortpkgs\fR [\fB\-s\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] \fIfilename\fR... {\-v\ |\ \-\-version} {\-h\ |\ \-\-help}

.SH "DESCRIPTION"

.PP

\fBapt\-sortpkgs\fR

will take an index file (source index or package index) and sort the records so that they are ordered by the package name\&. It will also sort the internal fields of each record according to the internal sorting rules\&.

.PP

All output is sent to standard output; the input must be a seekable file\&.

.SH "OPTIONS"

.PP

All command line options may be set using the configuration file, the descriptions indicate the configuration option to set\&. For boolean options you can override the config file by using something like

\fB\-f\-\fR,\fB\-\-no\-f\fR,

\fB\-f=no\fR

or several other variations\&.

.PP

\fB\-s\fR, \fB\-\-source\fR

.RS 4

Use source index field ordering\&. Configuration Item:

APT::SortPkgs::Source\&.

.RE

.PP

\fB\-h\fR, \fB\-\-help\fR

.RS 4

Show a short usage summary\&.

.RE

.PP

\fB\-v\fR, \fB\-\-version\fR

.RS 4

Show the program version\&.

.RE

.PP

\fB\-c\fR, \fB\-\-config\-file\fR

.RS 4

Configuration File; Specify a configuration file to use\&. The program will read the default configuration file and then this configuration file\&. If configuration settings need to be set before the default configuration files are parsed specify a file with the

\fBAPT_CONFIG\fR

environment variable\&. See

\fBapt.conf\fR(5)

for syntax information\&.

.RE

.PP

\fB\-o\fR, \fB\-\-option\fR

.RS 4

Set a Configuration Option; This will set an arbitrary configuration option\&. The syntax is

\fB\-o Foo::Bar=bar\fR\&.

\fB\-o\fR

and

\fB\-\-option\fR

can be used multiple times to set different options\&.

.RE

.SH "SEE ALSO"

.PP

\fBapt.conf\fR(5)

.SH "DIAGNOSTICS"

.PP

\fBapt\-sortpkgs\fR

returns zero on normal operation, decimal 100 on error\&.

.SH "BUGS"

.PP

\m[blue]\fBAPT bug page\fR\m[]\&\s-2\u[1]\d\s+2\&. If you wish to report a bug in APT, please see

/usr/share/doc/debian/bug\-reporting\&.txt

or the

\fBreportbug\fR(1)

command\&.

.SH "AUTHORS"

.PP

\fBJason Gunthorpe\fR

.RS 4

.RE

.PP

\fBAPT team\fR

.RS 4

.RE

.SH "NOTES"

.IP " 1." 4

APT bug page

.RS 4

\%http://bugs.debian.org/src:apt

.RE