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

OPTIONS

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

CONTACT

75       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>
76
77       The mail archives are hosted at <https://public-inbox.org/meta/> and
78       <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
79

81       Copyright all contributors <mailto:meta@public-inbox.org>
82
83       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>
84

SEE ALSO

86       lei-index(1)
87
88
89
90public-inbox.git                  1993-10-02                     LEI-IMPORT(1)
Impressum