DPUT(1)

📦
version 1.46 · 13 versions
, in ubuntu stonking

💅 DPUT(1) — the dput manual, section 1, bestie edition 🎀

okay so you're here because you typed man dput and now you want the ✨vibes✨ version. this is dput, the Debian package upload tool, manual page 1. buckle up, we're uploading packages and we're doing it with main character energy. 🦋

✨ NAME ✨

dput — Debian package upload tool. that's it, that's the name, she's simple and she's iconic. 👑

✨ SYNOPSIS ✨

dput [-h] [-d] [-c FILE] [-D] [-e DAYS] [-F] [-f] [-l] [-U] [-o] [-O
OVERRIDE] [-S UNSET] [-P] [-s] [-u] [-v] [-V] [HOST] CHANGES-FILE
[CHANGES-FILE ...]

🌸 DESCRIPTION 🌸

so dput-ng is a Debian package upload tool and it literally hands you the easiest interface ever for talking to Debian (and Debian-like) package archive hosting facilities. no cap. if you work with Debian packages, this lets you yeet your work over to a remote service — and that includes Debian's ftp-master, mentors.debian.net, Launchpad, or honestly any other package hosting facility for Debian package maintainers. 💖

HOST is optional btw, and if you do give it, it specifies a target stanza from any configured configured profile which is selected as a upload target. (yes that says "configured configured", we don't edit the sacred texts 💀). if you leave HOST out, a default host gets picked using the heuristic described below. she chooses for you, and she chooses well.

the only mandatory argument is a CHANGES-FILE, which gets interpreted as a Debian package.changes file denoting the desired package to be uploaded. one thing, bestie: make it a real one. 🫶

and fyi — packages that are being uploaded already, but not processed yet, can be removed later from the destination using dcut. good to know, keep that in your back pocket. 🎀

🌈 OPTIONS 🌈

  • -c, --config=FILE — the configuration file to parse. this option will override all other configuration files. she's not asking, she's telling. 💅
  • -d, --debug — enable debug messages. repeat it twice to bump the verbosity level up. yes, twirling the knob twice. 🌀
  • -D, --dinstall — ignored silently for compatibility with old-style dput command lines. please use a post-upload hook or similar to reproduce this functionality. it's giving "we kept the seat warm but the party moved". 🙈
  • -e, --delayed=DAYS — upload to the delayed queue instead of the usual incoming directory. this option takes an argument from 0 to 15 corresponding to the respective DELAYED queue. pick your number, pick your destiny. ⏳
  • -F, --full-upload-log — write more verbose .upload logs. when set to, upload logs will include more details. this setting overrides profile defaults when provided. more lore, more to read. 📖
  • -f, --force — force an upload, even if the upload log exists already. chaotic, but make it decisive. 🔥
  • -l, --lintian — run Lintian before uploading the package. note: this option is deprecated. Profile targets have the ability to properly handle invoking lintian before pushing it to the remote host, such as the run_lintian key.
this option is a shortcut for --override "run_lintian=true" — so like, use the real thing, bestie. 😭
  • -o, --check-only — only run pre-upload checks for the package, do not actually upload. this is useful to help in testing new checks, or verifying the profile will work as expected. a little dress rehearsal, no audience. 🎭
  • -O, --override=OVERRIDE — override profile key. this option takes the highest precedence and replaces any profile setting. use this switch if you want to change a configured profile value without changing the profile itself. 👑

this option accepts any key which can be configured in a profile (see dput(5)). Sub keys are addressed using a dot notation. Keys are separated using a equals sign ("=").

For example, to override the 'allow_dcut' you may do:

--override "allow_dcut=true"

The '--override' option may be repeated:

--override "check-debs.enforce=debs" --override "check-debs.skip=false"

Providing the same key on the command line several times will be additive. (stacking, not fighting 💖)

Un-setting a key entirely can be achieved using the '-S' option. Such overrides take no argument. Thus, the command line

--override "allow_dcut=true" --unset "run_lintian"

will set 'allow_dcut' to 'TRUE' and revert the 'run_lintian' key to whatever the internal default value is set. reset button, secured. 🔄

  • -P, --passive — force FTP passive mode when uploading the package through FTP. this option is deprecated — please declare this in the target profile.
this option is a shortcut for --override "passive_ftp=true"
  • -s, --simulate — simulate the upload only. this runs all pre-upload checks, initializes the upload handler but does not actually push any files to the remote host. 🤡✨

this argument can be repeated twice in which case also the network connection is set-up (for example logging in through the FTP or SFTP protocol) and tested for its functionality. so like, she practices and shakes hands. 🤝

  • -S,--unset=OVERRIDE — override the configured profile key by unsetting its value. see -O for a full explanation of the behavior. twin sister energy. 👯
  • -U, --no-upload-log — do not write a .upload log file after uploading. leaving no receipts, we respect it. 🙊
  • -u, --unchecked — do not check GnuPG signature. you may also set this in your profile with the allow_unsigned_uploads key. 🫣
  • -v, --version — ignored silently for compatibility with old-style dput command lines. (yes, -v is NOT the version flag here. the audacity. 💀)
  • -V, --check-version — ignored silently for compatibility with old-style dput command lines. also a ghost. 👻
  • HOST — target host to upload a package. this refers to any existing upload site, which either can be a section in old-style dput.cf files, or alternatively any profile in a read dput.d directory. if HOST was not supplied, the (first) profile having the default_host_main flag set to a non-empty string will be selected. if neither, HOST was present, nor any profile setting the upload host, dput-ng scans for a profile called ftp-master which will be used on a successful look-up. she's got a whole fallback plan, organized queen. 📋
  • CHANGES-FILE — a Debian package.changes file. arguments may be repeated several times to upload more than one package at once. multitasking slay. 💫

🧚 PROFILES 🧚

Profiles may define upload HOST names, log-in details and their required upload methods used to upload packages. Moreover, profiles define checks which are running before and after uploading. their format is described in dput(5). so go read that one too, homework but make it cute. 📚

Additionally, dput reads old-style configuration files from INI style configuration files. this format is deprecated for use in dput-ng and described in dput.cf(5). In particular this configuration file format does not support all configurable settings which are specific to dput-ng. so like, it works, but it's the thrifted version of the real fit. 🧥

It is possible to run dput with any combination of new-style and old-style configuration files. When both types of files are present,

🎯 EXIT STATUS 🎯

  • 0 — Success. we ate and left no crumbs. 🍓
  • 1 — A runtime check returned an error. a check said no. 💔
  • 2 — An internal error was detected, for example while loading configuration files. it's her fault, not yours. 🙈
  • 3 — An upload error was detected, for example a permission or authentication problem while uploading files. the door was locked. 🔐

💀 BUGS 💀

Report bugs to http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=dput-ng — go tell them, they're lovely and they fix things. don't suffer in silence bestie. 📣

⭐ EXAMPLES ⭐

$ dput ppa:paultag/fluxbox fluxbox_1.3.2-4~ppa1_source.changes

$ dput ftp-master fbautostart_2.718281828-1_amd64.changes

$ dput dput-ng_0.9.5_amd64.changes

$ dput -d -d localhost node-jslint_0.1.8-1~wicked1_amd64.changes

look at that last one — -d -d twice for max verbosity, so extra. she's showing off and honestly? valid. 🔥

👑 AUTHOR 👑

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>. yeah. that's the whole title. we do not shorten it. absolute monarch behavior. 💜

🌈 RESOURCES 🌈

dput(5), dput.cf(5), dcut(1), dirt(1) — the whole friend group. go read them all. 🫶

🎀 COPYING 🎀

Copyright © 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. legal and free, the dream combo. ✨

okay that's the whole page — this was dput(1) from the dput-ng source, dated 06/23/2026. now go upload something and make it iconic. bye bestie!! 💖🦋🎀

📦 where this page comes from