bionic (5) plowshare.conf.5.gz

Provided by: plowshare_2.1.7-1_all bug

NAME

       plowshare.conf - Configuration file for Plowshare

DESCRIPTION

       Plowshare   (plowdown,  plowup,  plowdel,  plowlist  or  plowprobe)  uses  a  configuration  file  called
       plowshare.conf for its initial setup. This configuration file is searched for  in  the  following  places
       when plowshare is started:

           ~/.config/plowshare/plowshare.conf
           /etc/plowshare.conf

       Instead  of  specifying  long  command  lines  with  user's preferences (credentials, network settings or
       download retry number, ...), it is convenient to make them default.

       Note: Usage of configuration file can be disabled using --no-plowsharerc command-line  option.  There  is
       also --plowsharerc=FILE option to specify an alternate configuration file.

FILE FORMAT

       plowshare.conf  file uses an INI-style format. It is composed of six sections which may be present in any
       order. Each section may contain lines of the form:

           [General]
               token = value
               ...
           [Plowdown]
               token = value
               ...
           [Plowup]
               token = value
               ...
           [Plowdel]
               token = value
               ...
           [Plowlist]
               token = value
               ...
           [Plowprobe]
               token = value
               ...

           # this is a comment

       Notes:

       • Sections are unordered.

       • Blank lines or lines beginning with a hash character ('#') are treated as comments and ignored.

       • Whitespace before and after a token or value is  ignored  (although  a  value  can  contain  whitespace
         within).

       • Double quoting value is optional. Use them to preserve leading and trailing whitespace.

       Valid  tokens  are  always  lowercase.   Names  are  long-option command-line arguments of plowshare. For
       example: temp-directory for plowdown.  For modules options, tokens are prepended by  module  name  and  a
       slash character. For example: rapidgator/auth (short-option are also possible here).

       For  values, no backslash interpretation is made. "\t" is a regular string with two characters, it is not
       a tab character.

       Options in general section prevail over Plow* section. Options given on the  command  line  prevail  over
       configuration file options.

EXAMPLE

       ###
       ### Plowshare configuration file
       ###

       [General]
       interface = eth1
       rapidshare/a = matt:4deadbeef
       rapidgator/a = "matt:4 dead beef "
       antigate=bc427381269d702eccc509b8849e5b0d

       [Plowdown]
       timeout=3600
       no-overwrite=1

       [Plowup]
       max-retries=2
       printf=Download URL: %u%nDelete   URL: %d%n
       uploadmemodule/auth-free = foo@bar.com:kjguiy1581!
       uploadmemodule/folder = incoming

       [Plowlist]
       verbose = 3

AUTHORS

       Plowshare  was  initially  written  by Arnau Sanchez. See the AUTHORS file for a list of some of the many
       other contributors.

       Plowshare is (C) 2010-2016 The Plowshare Team

SEE ALSO

       plowdown(1), plowup(1), plowdel(1), plowlist(1), plowprobe(1), plowmod(1).