NAME
lei-import - one-time import of messages into local store
SYNOPSIS
lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL]
lei import [OPTIONS] (--stdin|-)
DESCRIPTION
Import messages into the local storage of lei(1) (aka lei/store). "LOCATION" is a source of messages: a directory (Maildir), a file, or a URL ("imap://", "imaps://", "nntp://", or "nntps://"). URLs requiring authentication use git-credential(1) to fill in the username and password.
For a regular file, the "LOCATION" must have a "<format>:" prefix specifying one of the following formats: "mboxrd", "mboxcl2", "mboxcl", or "mboxo".
OPTIONS
- -F MAIL_FORMAT
- --in-format=MAIL_FORMAT
-
Message input format. Unless messages are given on stdin, using a format prefix with
"LOCATION"is preferred.
- --stdin
-
Read messages from stdin.
- --lock
-
mbox(5) locking method(s) to use:
"dotlock","fcntl","flock"or"none".Default: fcntl,dotlock
- +L:LABEL
-
Add the given
"LABEL"to all messages imported, where"LABEL"is an arbitrary user-defined value consisting of lowercase and digits. See lei-tag(1) for more info on labels.For example, specifying
"+L:inbox"applies the"inbox"label to all messages being imported.May be specified multiple times to apply multiple labels.
Default: none
- +kw:KEYWORD
-
Apply
"KEYWORD"to all messages being imported in addition to any per-message keywords from the store (unless"--no-kw"is specified). See lei-tag(1) for more info on keywords.May be specified multiple times to apply multiple keywords.
Default: none
- --no-kw
-
Don't import message keywords (or "flags" in IMAP terminology).
- --no-incremental
-
Import already seen IMAP and NNTP articles.
- --torsocks=auto|no|yes
- --no-torsocks
-
Whether to wrap git(1) and curl(1) commands with torsocks(1).
Default:
"auto"
- --proxy=PROTOCOL://HOST[:PORT]
-
Use the specified proxy (e.g.,
"socks5h://0:9050").Consider imap.proxy and nntp.proxy which can be persistently configured on a per-host basis in lei-config(1).
- --noisy
-
Warn on misformatted email headers. Not particularly useful but this was the default prior to public-inbox 2.0.0. New in public-inbox 2.0.0.
See lei-config(1) for various "imap.*" and "nntp.*" options.
CONTACT
Feedback welcome via plain-text mail to <mailto:[email protected]>
The mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
COPYRIGHT
Copyright all contributors <mailto:[email protected]>
License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>