1LEI-IMPORT(1)              public-inbox user manual              LEI-IMPORT(1)
2
3
4

NAME

6       lei-import - one-time import of messages into local store
7

SYNOPSIS

9       lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL]
10
11       lei import [OPTIONS] (--stdin|-)
12

DESCRIPTION

14       Import messages into the local storage of lei(1) (aka lei/store).
15       "LOCATION" is a source of messages: a directory (Maildir), a file, or a
16       URL ("imap://", "imaps://", "nntp://", or "nntps://").  URLs requiring
17       authentication use git-credential(1) to fill in the username and
18       password.
19
20       For a regular file, the "LOCATION" must have a "<format>:" prefix
21       specifying one of the following formats: "mboxrd", "mboxcl2", "mboxcl",
22       or "mboxo".
23

OPTIONS

25       -F MAIL_FORMAT
26       --in-format=MAIL_FORMAT
27           Message input format.  Unless messages are given on stdin, using a
28           format prefix with "LOCATION" is preferred.
29
30       --stdin
31           Read messages from stdin.
32
33       --lock
34           mbox(5) locking method(s) to use: "dotlock", "fcntl", "flock" or
35           "none".
36
37           Default: fcntl,dotlock
38
39       +L:LABEL
40           Add the given "LABEL" to all messages imported, where "LABEL" is an
41           arbitrary user-defined value consisting of lowercase and digits.
42           See lei-tag(1) for more info on labels.
43
44           For example, specifying "+L:inbox" applies the "inbox" label to all
45           messages being imported.
46
47           May be specified multiple times to apply multiple labels.
48
49           Default: none
50
51       +kw:KEYWORD
52           Apply "KEYWORD" to all messages being imported in addition to any
53           per-message keywords from the store (unless "--no-kw" is
54           specified).  See lei-tag(1) for more info on keywords.
55
56           May be specified multiple times to apply multiple keywords.
57
58           Default: none
59
60       --no-kw
61           Don't import message keywords (or "flags" in IMAP terminology).
62
63       --no-incremental
64           Import already seen IMAP and NNTP articles.
65
66       --torsocks=auto|no|yes
67       --no-torsocks
68           Whether to wrap git(1) and curl(1) commands with torsocks(1).
69
70           Default: "auto"
71
72       --proxy=PROTOCOL://HOST[:PORT]
73           Use the specified proxy (e.g., "socks5h://0:9050").
74
75           Consider imap.proxy and nntp.proxy which can be persistently
76           configured on a per-host basis in lei-config(1).
77
78       See lei-config(1) for various "imap.*" and "nntp.*" options.
79

CONTACT

81       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>
82
83       The mail archives are hosted at <https://public-inbox.org/meta/> and
84       <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
85

87       Copyright all contributors <mailto:meta@public-inbox.org>
88
89       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
90

SEE ALSO

92       lei-config(1), lei-index(1), lei-store-format(5)
93
94
95
96public-inbox.git                  1993-10-02                     LEI-IMPORT(1)
Impressum