'\" t
.\"     Title: apt-extracttemplates
.\"    Author: Jason Gunthorpe
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 27\ \&March\ \&2014
.\"    Manual: APT
.\"    Source: APT 2.9.10
.\"  Language: English
.\"
.TH "APT\-EXTRACTTEMPLATE" "1" "27\ \&March\ \&2014" "APT 2.9.10" "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-extracttemplates \- Utility to extract \fBdebconf\fR config and templates from Debian packages
.SH "SYNOPSIS"
.HP \w'\fBapt\-extracttemplates\fR\ 'u
\fBapt\-extracttemplates\fR [\fB\-t=\fR\fB\fItemporary_directory\fR\fR] \fIfilename\fR... {\-v\ |\ \-\-version} {\-h\ |\ \-\-help}
.SH "DESCRIPTION"
.PP
\fBapt\-extracttemplates\fR
will take one or more Debian package files as input and write out (to a temporary directory) all associated config scripts and template files\&. For each passed in package that contains config scripts and templates, one line of output will be generated in the format:
.PP
package version template\-file config\-script
.PP
template\-file and config\-script are written to the temporary directory specified by the
\fB\-t\fR
or
\fB\-\-tempdir\fR
(APT::ExtractTemplates::TempDir) directory, with filenames of the form
package\&.template\&.XXXXXX
and
package\&.config\&.XXXXXX
.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\-t\fR, \fB\-\-tempdir\fR
.RS 4
Temporary directory in which to write extracted
\fBdebconf\fR
template files and config scripts\&. Configuration Item:
APT::ExtractTemplates::TempDir
.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\-\-audit\fR
.RS 4
Show audit (and notice) messages\&. This overrides the quiet option, but only for notice messages, not progress ones\&.
.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
.PP
\fB\-\-no\-color\fR, \fB\-\-color\fR
.RS 4
Turn colors on or off\&. Colors are on by default on supported terminals for
\fBapt\fR(8)
and can also be disabled using the
\fBNO_COLOR\fR
or
\fBAPT_NO_COLOR\fR
environment variables, or further configured by the
\fBAPT::Color\fR
configuration option and scope, see
\fBapt.conf\fR(5)
for information on that\&.
.RE
.SH "SEE ALSO"
.PP
\fBapt.conf\fR(5)
.SH "DIAGNOSTICS"
.PP
\fBapt\-extracttemplates\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
\%https://bugs.debian.org/src:apt
.RE