mirror of
https://github.com/rclone/rclone.git
synced 2025-01-08 07:20:42 +01:00
press: initial documentation
This commit is contained in:
buengese
parent
ba6b077b30
commit
10a3129049
@ -44,6 +44,7 @@ using local disk.
|
||||
Virtual backends wrap local and cloud file systems to apply
|
||||
[encryption](/crypt/),
|
||||
[caching](/cache/),
|
||||
[compression](/press/)
|
||||
[chunking](/chunker/) and
|
||||
[joining](/union/).
|
||||
|
||||
|
||||
137
docs/content/press.md
Normal file
137
docs/content/press.md
Normal file
@ -0,0 +1,137 @@
|
||||
---
|
||||
title: "Press"
|
||||
description: "Compression Remote"
|
||||
date: "2020-09-14"
|
||||
---
|
||||
|
||||
Press (Experimental)
|
||||
-----------------------------------------
|
||||
|
||||
The `press` remote adds compression to another remote. It is best used with remotes containing
|
||||
many large compressible files or on top of other remotes like crypt.
|
||||
|
||||
Please read the [warnings](#warnings) before using this remote.
|
||||
|
||||
To use this remote, all you need to do is specify another remote and a compression mode to use:
|
||||
|
||||
```
|
||||
Current remotes:
|
||||
|
||||
Name Type
|
||||
==== ====
|
||||
remote_to_press sometype
|
||||
|
||||
e) Edit existing remote
|
||||
$ rclone config
|
||||
n) New remote
|
||||
d) Delete remote
|
||||
r) Rename remote
|
||||
c) Copy remote
|
||||
s) Set configuration password
|
||||
q) Quit config
|
||||
e/n/d/r/c/s/q> n
|
||||
name> press
|
||||
...
|
||||
8 / Compress a remote
|
||||
\ "press"
|
||||
...
|
||||
Storage> press
|
||||
** See help for press backend at: https://rclone.org/press/ **
|
||||
|
||||
Remote to compress.
|
||||
Enter a string value. Press Enter for the default ("").
|
||||
remote> remote_to_press:subdir
|
||||
Compression mode.
|
||||
Enter a string value. Press Enter for the default ("gzip").
|
||||
Choose a number from below, or type in your own value
|
||||
1 / Gzip compression balanced for speed and compression strength.
|
||||
\ "gzip"
|
||||
compression_mode> gzip
|
||||
Edit advanced config? (y/n)
|
||||
y) Yes
|
||||
n) No (default)
|
||||
y/n> n
|
||||
Remote config
|
||||
--------------------
|
||||
[press]
|
||||
type = press
|
||||
remote = remote_to_press:subdir
|
||||
compression_mode = gzip
|
||||
--------------------
|
||||
y) Yes this is OK (default)
|
||||
e) Edit this remote
|
||||
d) Delete this remote
|
||||
y/e/d> y
|
||||
```
|
||||
|
||||
### Compression Modes
|
||||
Currently only gzip compression is supported, it provides a decent balance between speed and strength and is well
|
||||
supported by other application. Compression strength can further be configured via an advanced setting where 0 is no
|
||||
compression and 9 is strongest compression.
|
||||
|
||||
#### Filetype
|
||||
If you open a remote wrapped by press, you will see that there are many files with an extension corresponding to
|
||||
the compression algorithm you chose. These files are standard files that can be opened by various archive programs,
|
||||
but they have some hidden metadata that allows them to be used by rclone.
|
||||
While you may download and decompress these files at will, do **not** upload any compressed files to a wrapped remote
|
||||
through any other means than rclone. This will upload files that do not contain metadata and **will** cause unexpected behavior.
|
||||
|
||||
### File names
|
||||
|
||||
The compressed files will be named `*################.gz` where `*` is the base file and the `#` part is the size
|
||||
of the uncompressed data written as a hexadecimal number. The file names should not be changed by anything other than
|
||||
the rclone compression backend.
|
||||
|
||||
#### Experimental
|
||||
This remote is currently **experimental**. Things may break and data may be lost. Anything you do with this remote is
|
||||
at your own risk. Please understand the risks associated with using experimental code and don't use this remote in
|
||||
critical applications.
|
||||
|
||||
{{< rem autogenerated options start" - DO NOT EDIT - instead edit fs.RegInfo in backend/press/press.go then run make backenddocs" >}}
|
||||
### Standard Options
|
||||
|
||||
Here are the standard options specific to press (Compress a remote).
|
||||
|
||||
#### --press-remote
|
||||
|
||||
Remote to compress.
|
||||
|
||||
- Config: remote
|
||||
- Env Var: RCLONE_PRESS_REMOTE
|
||||
- Type: string
|
||||
- Default: ""
|
||||
|
||||
#### --press-mode
|
||||
|
||||
Compression mode.
|
||||
|
||||
- Config: mode
|
||||
- Env Var: RCLONE_PRESS_MODE
|
||||
- Type: string
|
||||
- Default: "gzip"
|
||||
- Examples:
|
||||
- "gzip"
|
||||
- Standard gzip compression with fastest parameters.
|
||||
|
||||
### Advanced Options
|
||||
|
||||
Here are the advanced options specific to press (Compress a remote).
|
||||
|
||||
#### --press-level
|
||||
|
||||
GZIP compression level (-2 to 9).
|
||||
|
||||
Generally -1 (default, equivalent to 5) is recommended.
|
||||
Levels 1 to 9 increase compressiong at the cost of speed.. Going past 6
|
||||
generally offers very little return.
|
||||
|
||||
Level -2 uses Huffmann encoding only. Only use if you now what you
|
||||
are doing
|
||||
Level 0 turns off compression.
|
||||
|
||||
- Config: level
|
||||
- Env Var: RCLONE_PRESS_LEVEL
|
||||
- Type: int
|
||||
- Default: -1
|
||||
|
||||
{{< rem autogenerated options stop >}}
|
||||
Loading…
Reference in New Issue
Block a user