plowup(1) - Linux man page

Name

websites

Synopsis

Description

Currently supported hosting sites list is available in README file.

Anonymous upload is not allowed by all sites, some of them may require authentication. See specific module options below.

Options

Common options

-i, --interface=IFACE

If your machine has several network interfaces, force using IFACE interface.

--max-rate=SPEED

Limit upload maximum speed in bytes per second. Suffixes are:

k for kilobytes (kB i.e. 1000),

M for megabytes (MB i.e. 1000^2),

K or Ki for kibibytes (KB or KiB i.e. 1024),

m or Mi for mebibytes (mB or MiB i.e. 1024^2).

--min-rate=SPEED

Limit upload minimum speed in bytes per second (for a delay of 30 seconds). Suffixes are the same than --max-rate.

-t, --timeout=SECS

Cancel upload download after SECS seconds of waits. Apply on module exit value: 10 (temporary unavailable error). This error mainly occurs on remote upload operations. Default option value is disabled (no timeout, infinite) and applies for one single upload.

-r, --max-retries=N

Set maximum retries for upload failures. Apply on module exit value: 1 (fatal error), 3 (network error). Default option value is 0 (no retry) and applies for one single upload.

--name-prefix=STRING

Prepend argument to each destination filename.

--name-suffix=STRING

Append argument to each destination filename.

--printf=FORMAT

Print results in a given format (for each upload). Default string is: "%D%A%u". Interpreted sequences are:

%%

raw % character

%a

admin url or admin code (rare case)

%A

empty if %a is empty, or alias to "#ADM %a%n".

%d

delete url

%D

empty if %d is empty, or alias to "#DEL %d%n".

%f

destination (remote) filename

%m

module name

%n

newline

%s

filesize (in bytes)

%t

tabulation character

%u

Logging options

-v, --verbose=LEVEL

Set output verbose level:

0 none,

1 errors,

2 notice (default behavior),

3 debug,

4 report (very noisy, log HTML pages).

-q, --quiet

Alias for -v0. Do not print any debug messages.

Miscellaneous options

--no-curlrc

Do not use curl config file (~/.curlrc).

--no-plowsharerc

Do not use local or global config file (plowshare.conf).

Generic program information

-h, --help

Display main help and exit.

-H, --longhelp

Display complete help (with module options) and exit.

--version

Output version information and exit.

Module Options

Common options

-a, --auth=USER:PASSWORD

Use premium account.

-b, --auth-free=USER:PASSWORD

Use free account.

-p, --link-password=PASSWORD

Protect your files with a password. May require premium account.

-d, --description=DESCRIPTION

Set file description.

--email-from=EMAIL

<From> field for notification email.

--email-to=EMAIL

<To> field for notification email.

All switches are not implemented nor required for all modules. See long help message for detailed modules option list.

Examples

1) Upload a single file anonymously

$ plowup bayfiles /tmp/foo.bar

# Add a text description
$ plowup -d "Important document" megashares /path/myfile.tex

# Abort slow upload (if rate is below limit during 30 seconds)
$ plowup --min-rate 100k mediafire /path/bigfile.zip

2) Upload a single file with authentication

# Change destination filename
$ plowup -a myuser:mypassword turbobit /path/myfile.txt:anothername.txt

3) Remote upload

# Feature dedicated to premium members
$ plowup -a myuser:mypassword oron http://www.somewherefarbeyond.com/somefile

# Change destination filename
$ plowup -a myuser:mypassword oron http://www.somewherefarbeyond.com/somefile:anothername

Files

~/.config/plowshare/plowshare.conf

This is the per-user configuration file.

/etc/plowshare.conf

Systemwide configuration file.

The file format is described in plowshare.conf(5).

Exit Codes

Possible exit codes are:

0

Success.

1

Fatal error. Upstream site updated or unexpected result.

2

No available module (provided module name does not exist).

3

Network error. Mostly curl related.

4

Authentication failed (bad login/password).

5

Timeout reached (refer to -t/--timeout command-line option).

6

Maximum tries reached (refer to -r/--max-retries command-line option).

8

System generic error.

10

Feature (upload service) seems temporarily unavailable from upstream.

12

Authentication required (example: anonymous users can't do remote upload).

14

Can't upload too big file (hoster limitation or requires more permissions).

15

Unknown command line parameter or incompatible options.

If plowup is invoked with multiple files and one or several errors occur, the first error code is returned added with 100.

Authors

Plowshare is (C) 2010-2013 The Plowshare Team

See Also