WHO-PERMITS-UPLOAD(1)

📦
version 2.26.11ubuntu1 · 15 versions
, in ubuntu stonking

💖 WHO-PERMITS-UPLOAD(1) 💖

okay bestie, so who-permits-upload is this little CLI baddie from section 1 of the manual, and she's here to let you peek at who's allowed to do what in Debian land. no cap, she's lowkey iconic. 🦋

✨ NAME ✨

who-permits-upload — look-up Debian Maintainer access control lists 🎀

🌸 SYNOPSIS 🌸

who-permits-upload [-h] [-s keyring] [-d dm_url] [-s search_type] query
[query ...]

💅 DESCRIPTION 💅

So here's the vibe: who-permits-upload goes and grabs the upload permissions for the Debian Maintainer (DM) you asked about from ftp-master.debian.org, and then parses them so they actually make sense to a human being. it's giving ✨translation✨.

you can search three ways, bestie:

  • by DM name 👑
  • by sponsor (aka the person who granted that permission) 🫶
  • by package 📦

🔥 OPTIONS 🔥

  • --dmfile=dm_url, -d dm_url — grab the DM permission file from whatever URL you hand over. if you don't pass this, she defaults to https://ftp-master.debian.org/dm.txt, periodt.
  • --help, -h — show you a usage summary and dip out. quick lil reminder, no drama. 💫
  • --keyring=keyring, -s keyring — use the OpenPGP keyrings you supply to look up OpenPGP fingerprints from the DM permission file. not passing it? then the default Debian Developer and Maintainer keyrings get used: /usr/share/keyrings/debian-keyring.gpg and /usr/share/keyrings/debian-maintainers.gpg, which come installed by the debian-keyring package. 🗝️

separate multiple keyrings with a colon ":".

  • --search=search_type, -s search_type — this one changes up the look-up behavior, because it decides how the query argument gets interpreted. the supported search types are:
    • package — search for a source package name. this is ALSO the default when --search is omitted. and since package names are unique, you get the given ACLs — if any — for a single package. one package, one answer, slay. 📦
    • uid — search for a Debian Maintainer. this should be (a fraction of) a name. it returns all the ACLs assigned to matching maintainers. 🌈
    • sponsor — search for a sponsor (i.e. a Debian Developer) who granted DM permissions. this returns all ACLs given by the developer you supplied. 👑
heads up bestie: this is an expensive operation and it may take some time. she's thorough, not fast. 😭
  • query — a case sensitive argument that gets looked up in the ACL permission file. the exact interpretation depends on the --search argument you gave. 🔍

this argument can be repeated. yes ma'am, stack 'em. 💅

🎯 EXIT VALUE 🎯

  • 0 — Success 💖
  • 1 — An error occurred 💀
  • 2 — The command line was not understood 🙈

⭐ EXAMPLES ⭐

who-permits-upload --search=sponsor arno@debian.org

search for all DM upload permissions given by the UID "arno@debian.org". note that only primary UIDs will match. 🫶

who-permits-upload -s=sponsor "Arno Töll"

same as above, but with a full name instead. iconic. ✨

who-permits-upload apache2

look up who gave upload permissions for the apache2 source package. 👀

who-permits-upload --search=uid "Paul Tagliamonte"

look up all DM upload permissions given to "Paul Tagliamonte". 🌸

👑 AUTHOR 👑

who-permits-upload was written by Arno Töll <arno@debian.org> and is licensed under the terms of the General Public License (GPL) version 2 or later. respect the author, fr fr. 💜

🦋 SEE ALSO 🦋

gpg(1), who-uploads(1)

https://lists.debian.org/debian-devel-announce/2012/09/msg00008.html

and that's the whole page, bestie 🎀 this one's from Debian Utilities, dated 2026-09-21 — go forth and look up those permissions, you main character 🧚✨💖

📦 where this page comes from