who-permits-upload(1)

1WHO-PERMITS-UPLOAD(1)                                    WHO-PERMITS-UPLOAD(1)
2
3
4

NAME

6       who-permits-upload - look-up Debian Maintainer access control lists
7

SYNOPSIS

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

DESCRIPTION

13       who-permits-upload looks up the given Debian Maintainer (DM) upload
14       permissions from ftp-master.debian.org and parses them in a human
15       readable way. The tool can search by DM name, sponsor (the person who
16       granted the permission) and by package.
17

OPTIONS

19       --dmfile=dm_url, -d dm_url
20           Retrieve the DM permission file from the supplied URL. When this
21           option is not present, the default value
22           https://ftp-master.debian.org/dm.txt is used.
23
24       --help, -h
25           Display a usage summary and exit.
26
27       --keyring=keyring, -s keyring
28           Use the supplied GnuPG keyrings to look-up GPG fingerprints from
29           the DM permission file. When not present, the default Debian
30           Developer and Maintainer keyrings are used
31           (/usr/share/keyrings/debian-keyring.gpg and
32           /usr/share/keyrings/debian-maintainers.gpg, installed by the
33           debian-keyring package).
34
35           Separate keyrings with a colon ":".
36
37       --search=search_type, -s search_type
38           Modify the look-up behavior. This influences the interpretation of
39           the query argument. Supported search types are:
40
41           package
42               Search for a source package name. This is also the default when
43               --search is omitted.  Since package names are unique, this will
44               return given ACLs - if any - for a single package.
45
46           uid Search for a Debian Maintainer. This should be (a fraction of)
47               a name. It will return all ACLs assigned to matching
48               maintainers.
49
50           sponsor
51               Search for a sponsor (i.e. a Debian Developer) who granted DM
52               permissions. This will return all ACLs given by the supplied
53               developer.
54
55               Note that this is an expensive operation which may take some
56               time.
57
58       query
59           A case sensitive argument to be looked up in the ACL permission
60           file. The exact interpretation of this argument is dependent by the
61           --search argument.
62
63           This argument can be repeated.
64

EXIT VALUE

66       0   Success
67
68       1   An error occurred
69
70       2   The command line was not understood
71

EXAMPLES

73       who-permits-upload --search=sponsor arno@debian.org
74           Search for all DM upload permissions given by the UID
75           "arno@debian.org". Note, that only primary UIDs will match.
76
77       who-permits-upload -s=sponsor "Arno Töll"
78           Same as above, but use a full name instead.
79
80       who-permits-upload apache2
81           Look up who gave upload permissions for the apache2 source package.
82
83       who-permits-upload --search=uid "Paul Tagliamonte"
84           Look up all DM upload permissions given to "Paul Tagliamonte".
85

AUTHOR

87       who-permits-upload was written by Arno Töll <arno@debian.org> and is
88       licensed under the terms of the General Public License (GPL) version 2
89       or later.
90