1LEI-IMPORT(1) public-inbox user manual LEI-IMPORT(1)
2
3
4
6 lei-import - one-time import of messages into local store
7
9 lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL]
10
11 lei import [OPTIONS] (--stdin|-)
12
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
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=PROTOCOL://HOST[:PORT]
72 Use the specified proxy (e.g., "socks5h://0:9050").
73
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
86 lei-index(1)
87
88
89
90public-inbox.git 1993-10-02 LEI-IMPORT(1)