FAQ

   1 1. Why can't the option -D be used with ftp uploads?
   2
   3    Because the ftp upload method uses anonymous upload queues, which
   4    don't know anything about the user or dinstall. They will just
   5    accept every Debian package and later upload it to the incoming
   6    directory of ftp.upload.debian.org.
   7
   8 2. Why don't you change the suffix .cf to .conf for consistency purpose?
   9
  10    At the time, where I had to decide on a suffix for the
  11    configuration file, I had the offer to user either "rc", ".cf" or
  12    ".conf". If you look at the dot files in your homedir or the files
  13    in /etc, you'll notice that there's no standard and that every of
  14    these three extension is used. Since I wanted to have a short
  15    suffix, I had to decide between "rc" or ".cf". I decided to use
  16    ".cf" as suffix, because it's an obvious abbreviation for
  17    configuration and also I noticed that postfix uses it as extension.
  18    Since this extension has now been used for quite some time, I'm not
  19    planning to change it. Any change would need a lot of work or
  20    introduce problems for the users.
  21
  22 3. Why can't dput act like dupload and just use every file in the
  23    directory?
  24
  25    Well, dput was not written as a dupload-in-Python, but as an
  26    alternative tool for uploading Debian packages. dput and dupload
  27    are completely different, especially since dput supports modules.
  28    I only took one or two ideas from dupload, especially the hooks,
  29    but won't implement any further options or features.
  30
  31 4. Why should I switch to dput since dupload works for me?
  32
  33    Because dput will make you rich and attractive.
  34
  35    Now, seriously, it's a matter of preferences. If you use dupload
  36    and like its behaviour, then continue to use it. But in every
  37    case, I would suggest that you try dput, since it will check the
  38    GnuPG signature and the checksums before uploading and offer to run
  39    dinstall in dry-run mode after the upload. It also offers the usage
  40    of other upload methods via modules.
  41
  42 5. Where are modules and what are they exactly used for?
  43
  44    dput uses modules for the different upload methods that it offers.
  45    All upload methods are implemented via seperate modules that will
  46    be loaded at runtime. That way we can easily extend the number of
  47    upload methods that dput offers. So if you write or already wrote a
  48    new upload method, then please inform the author of dput, so that
  49    it maybe can be added to dput in the future.
  50
  51 6. Can I just copy /etc/dput.cf into my homedir as .dput.cf?
  52
  53    No, this shouldn't be done, because .dput.cf is a configuration
  54    file for the user. It should only contain configuration variables
  55    which have a value different from the default and which the user
  56    needs to define. This will reduce the risk of breaking dput, if
  57    either some default value in /etc/dput.cf is changed or a new
  58    configuration variable is added.
  59
  60 7. How can I set up my own local APT repository and use dput for
  61    installing?
  62
  63    There are many ways to maintain APT repositories. Using Colin
  64    Walters' mini-dinstall-Package is perhaps the easiest way (if you run
  65    sarge or later). If you want to have the repository on a remote
  66    machine, see question 8. For a local repository you might use our
  67
  68    MICRO RECIPE FOR PERSONAL MINI-DINSTALL REPOSITORY
  69    The following dput and mini-dinstall configuration works for the
  70    mainters of dput. For your convenience we have included a "local"
  71    dput target in the stock debian dput.cf which can be used with the
  72    mini-dinstall configuration below.
  73    For simplicity, we do not use the daemon mode of mini-dinstall. As
  74    mini-dinstall has rather flexible configuration options, you might
  75    want to consider reading the documentation yourself, but the file
  76    file below should work out of the box to implement most simple setup.
  77    After copying the configuration file below into your home directory
  78    do mkdir -p public_html/debian ; mini-dinstall --batch
  79    in your home directory to setup your repository.
  80
  81    ~/.mini-dinstall.conf:
  82    # Adapted Colin's mini-dinstall.conf
  83    [DEFAULT]
  84    architectures = all, i386
  85    archivedir = ~/public_html/debian/
  86    use_dnotify = 0
  87    verify_sigs = 0
  88    extra_keyrings = ~/.gnupg/pubring.gpg
  89    mail_on_success = 0
  90    archive_style = flat
  91    poll_time = 10
  92    mail_log_level = NONE
  93    [stable]
  94    [testing]
  95    [unstable]
  96
  97
  98 8. How do I set up dput to fill my remote APT repository?
  99
 100    Assuming you have remote ssh access, you can use the following
 101    You can use the same mini-dinstall configuration file (and setup
 102    command) as for a local repository on the remote machine.
 103    As ~/.dput.cf you now can use
 104
 105    [myremote]
 106    fqdn = remote.machine.net
 107    login = usernameonremote
 108    method = scp
 109    incoming = ~/public_html/debian/mini-dinstall/incoming
 110    run_dinstall = 0
 111    post_upload_command = ssh usernameonremote@remote.machine.net /usr/bin/mini-dinstall --batch