Migrate from ‘dinstall’ global name, to a function parameter.
[dput.git] / dput.1
blob7b6b91eb1f87a5f342081902cd780de2972635f8
1 .TH dput 1 "2001-10-05"
2 .SH NAME
3 .B dput
4 \- package upload tool for Debian
5 .SH SYNTAX
6 .B dput
7 [\fIoptions\fR]
8 [\fBhost\fR]
9 \fBpackage.changes\fR ...
10 .SH DESCRIPTION
11 This is a tool for uploading Debian packages into the archive. You may specify
12 to which host it should upload the file by passing it an
13 .I host
14 argument. If omitted, dput uses the host specified by
15 .I default_host
16 (or, historically \fIdefault_host_non-us\fR) configuration option.
17 Also you have to pass the program one or more name of
18 .I package.changes
19 files and then they will be sequentially uploaded.
21 This program will then upload the package for you into the archive, using a
22 selected upload method. Currently dput supports ftp, scp, rsync, http,
23 https, and local. The
24 method scripts have been split from the main script so it is easy to add
25 new methods.  Look in /usr/share/dput/ for examples.
27 Should something go wrong with your upload to destinations using the
28 Debian upload queue daemon (e.g. ftp-master), you can remove files from
29 the upload queue with \fBdcut\fP(1).
30 .SH OPTIONS
31 .BR "\-c",
32 .B \-\-config
33 \- define a config file to use.
35 .BR "\-d",
36 .B \-\-debug
37 \- activate debugging mode, helpful if bugs occur.
39 .BR "\-D",
40 .B \-\-dinstall
41 \- do a dry run of dinstall after the upload.
43 .BR "\-f",
44 .B \-\-force
45 \- force an upload of an already uploaded package.
47 .BR "\-h",
48 .B \-\-help
49 \- print help information and exit.
51 .BR "\-H",
52 .B \-\-host\-list
53 \- print the lists of hosts that dput knows about.
55 .BR "\-l",
56 .B \-\-lintian
57 \- run lintian before the upload.
59 .BR "\-U",
60 .B \-\-no-upload\-log
61 \- do not write a .upload log file after uploading.
63 .BR "\-o",
64 .B \-\-check-only
65 \- check only the package and do not upload.
67 .BR "\-p",
68 .B \-\-print
69 \- print the configuration that dput is using.
71 .BR "\-P",
72 .B \-\-passive
73 \- use passive ftp instead of active. Note that passive ftp is the default
74 unless specified otherwise in the configuration file.
76 .BR "\-s",
77 .B \-\-simulate
78 \- simulate an upload only.
80 .BR "\-u",
81 .B \-\-unchecked
82 \- don't check GnuPG signature on the changes file.
84 .BR "\-e",
85 .B \-\-delayed
86 \- Upload to a DELAYED queue, rather than the usual Incoming. This
87 takes an argument from 0 to 15. Note that a delay of 0 is different
88 from no delay at all.
90 .BR "\-v",
91 .BR \-\-version
92 \- print version information and exit.
94 .BR "\-V",
95 .BR \-\-check\-version
96 \- check if the user has already installed and tested the package before
97 putting it into the archive.
100 .SH ENVIRONMENT
101 This program doesn't depend on any environment variables. But if the variable
102 USER is set, it will be used.
104 .SH LICENSE
105 This program is distributed under the terms of the GPL.
107 .SH BUGS
109 Please send bug reports to the author.
111 .SH FILES
113 .I /etc/dput.cf
114 global dput configuration file
116 .I ~/.dput.cf
117 per user dput configuration file
119 .SH SEE ALSO
120 .PD 0
122 \fBdput.cf\fP(5)
124 \fBdcut\fP(1)
126 \fI/usr/share/doc/dput\fP
128 \fI/usr/share/dput\fP
130 .SH AUTHOR
131 \fIdput\fP was written Christian Kurz. The current maintainer is
132 Thomas Viehmann <tv@beamnet.de>.
134 Many other people have contributed to this code. See the
135 Thanks file.
137 .SH COMMENTS
138 The author does appreciate comments and suggestions from you.
140 .\" Local variables:
141 .\" mode: nroff
142 .\" coding: utf-8
143 .\" End:
144 .\" vim: fileencoding=utf-8 filetype=nroff :