'\" t
.\"     Title: dput.cf
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 02/17/2024
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DPUT\&.CF" "5" "02/17/2024" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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"
dput.cf \- Debian package upload tool configuration file
.SH "DESCRIPTION"
.sp
This manpage gives a brief overview of dput\(cqs configuration file and the available options in it\&. dput is a tool to upload Debian packages to the archive\&.
.SH "FILES AND FORMAT"
.sp
\fBdput\fR reads, in order, these files:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\fI/etc/dput\&.cf\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\fI$XDG_CONFIG_HOME/dput/dput\&.cf\fR, or if that does not exist
\fI~/\&.dput\&.cf\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
The file supplied via command line argument
.RE
.sp
By default \fBall\fR configuration file locations are parsed, and overlaid in a additive manner\&. This way both, entire profiles and actual settings within a profile is inherited from any parent location defining a key within the current scope\&.
.sp
dput\&.cf consists of different groups of configuration options, one for each host where you want to be able to upload packages\&. Hosts are defined using an identifier header with a short name for the host, enclosed in square brackets\&. Note that only if multiple such headers are encountered in the configuration, only the group following the last header is considered\&. This is done to avoid confusion when overriding a global configuration file with a user\-specific one\&. There\(cqs a special identifier, [DEFAULT], which holds default parameters for all the hosts\&. The defaults can be overridden by redefining them again in each host section\&.
.SS "SUPPORTED KEYS"
.sp
These keys are supported in dput\&.cf files\&. For their meaning refer to \fBdput(5)\fR\&.
.sp
\fBallow_dcut\fR, \fBallow_unsigned_uploads\fR, \fBallowed_distributions\fR, \fBdefault_host_main\fR, \fBdefault_keyid\fR, \fBfqdn\fR, \fBdistributions\fR, \fBhash\fR, \fBincoming\fR, \fBmethod\fR, \fBlogin\fR, \fBpassive_ftp\fR, \fBpost_upload_command\fR, \fBpre_upload_command\fR, \fBrun_lintian\fR\&.
.SS "UNSUPPORTED LEGACY KEYS"
.sp
These keys known and understood to the original dput implementation are not understood by dput\-ng:
.PP
\fBdelayed\fR
.RS 4
This key is not supported\&. Use the
\fI\fB\-\-delayed\fR\fR
switch from the command line, or set
\fBincoming\fR
to the actual delayed directory if you really rely on this key\&.
.RE
.PP
\fBrun_dinstall\fR
.RS 4
Not supported\&. Please submit a post\-upload hook if you\(cqd like to run
\fBdinstall\fR\&.
.RE
.PP
\fBcheck_version\fR
.RS 4
Not supported\&.
.RE
.PP
\fBprogress_indicator\fR
.RS 4
Not supported yet\&.
.RE
.PP
\fBscp_compress\fR
.RS 4
SCP compression is enabled by default\&. This is, however not configurable currently\&.
.RE
.PP
\fBssh_config_options\fR
.RS 4
Not supported\&. Please switch to the
\fIsftp\fR
method which supports your options from
\fBssh_config(5)\fR
natively\&.
.RE
.SS "UNSUPPORTED KEYS"
.sp
These keys are not supported in old\-style configuration files\&. However, their values are inherited from their new\-style defaults\&. See \fBdput(5)\fR for details:
.sp
\fBdefault_keyid\fR, \fBhooks\fR, \fBinterface\fR, \fBmeta\fR, \fBfull_upload_log\fR\&.
.SH "BUGS"
.sp
Please send bug reports to the author\&.
.SH "FILES"
.PP
\fI/etc/dput\&.cf\fR
.RS 4
global dput configuration file
.RE
.PP
\fI$XDG_CONFIG_HOME/dput/dput\&.cf\fR or \fI~/\&.dput\&.cf\fR
.RS 4
peruser dput configuration file
.RE
.SH "AUTHOR"
.sp
dput was originally written by Christian Kurz\&. Updated by Thomas Viehmann <tv@beamnet\&.de>\&. dput\-ng does not re\-use notable portions of code, but was heavily inspired by its behavior\&. Much appreciated\&.
.sp
dput\-ng was originally written by Arno Töll <arno(a)debian\&.org> and Paul Richard I by the Grace of God of the United Kingdom of Debian and Ubuntu and of his other realms and territories King Head of the Fluxbox Window Manager Defender of the Faith Tagliamonte <paultag(a)debian\&.org>\&.
.SH "SEE ALSO"
.sp
\fBdput(1)\fR, \fBdput(5)\fR
.SH "COPYING"
.sp
Copyright \(co 2012 dput\-ng authors\&. Free use of this software is granted under the terms of the GNU General Public License (GPL) Version 2 or later\&.