RCVSTORE(1)

💌 NAME 💌

rcvstore — asynchronously incorporate mail into an nmh folder. bestie, it's the lil guy that quietly files your mail while you're not looking ✨

---

🦋 SYNOPSIS 🦋

/usr/libexec/nmh/rcvstore [-help] [-version] [+folder] [-create |
     -nocreate] [-unseen | -nounseen] [-zero | -nozero] [-sequence name
     ...]  [-public | -nopublic]

---

🌸 DESCRIPTION 🌸

okay so. rcvstore takes a message from standard input and tucks it into an nmh folder. that's the whole job. main character behavior, honestly — shows up, does one thing, leaves. 💅

the way it's usually used is alongside mail filtering programs like slocal and procmail, so your mail can get sorted into different folders as it comes in. yes, that's the vibe. 🎀

📁 which folder tho

you tell it where to go with +folder. and if you don't? it checks for a non-empty "Inbox:" entry in your profile, and if that's not there either it just uses the folder literally named "inbox". default queen. 👑

✨ creating folders

if you pass -create (and bestie, it's the default, so you already are) and the folder you asked for — or the default one — doesn't exist, it gets created. easy. you can turn that off with -nocreate, and then if the folder doesn't exist, rcvstore just exits. no folder, no service. 😭

once the new message lands in the folder, it gets the next highest number for that folder. numbered, seated, iconic. 🔥

🫶 what it does to your message

rcvstore will incorporate anything except zero length messages into your nmh folder. and it will not change the message in any way. zero editing. it's giving respectful. ✨

🔐 permissions, we care about those

if your profile has a "Msg-Protect: nnn" entry, that's used as the mode — in octal — for the newly created message. no entry? then the nmh default mode of 0600 gets used, see chmod(1) (on filesystems that support it, iykyk). and for all subsequent operations on that message, this initially assigned mode is preserved. it locks in. 💅

👀 unseen sequences

if you pass -unseen (on by default, so again, you already are) and your profile entry "Unseen-Sequence" is present and non-empty, then rcvstore adds the newly incorporated message to every sequence named by that profile entry. don't want that? -nounseen and it's gone. 🙈

⚠️ important: these sequences will not be zeroed by rcvstore before it adds the new message. no zeroing. don't come for me.

🎯 extra sequences

incoming messages can also be added to additional sequences as they arrive, using the -sequence switch. and just like with the commands pick and mark, you've got -zero and -nozero to say whether to zero old sequences or not. same energy, -public and -nopublic let you force these sequences to be public or private. choose your fighter. ⭐

🔒 Locking and sequences

this is the part where we get real for a sec. 💀

if you use the "Unseen-Sequence" profile entry, or if you use the -sequence argument, rcvstore might try to update its sequence state while another nmh process is also trying to do so. and that can cause one of those updates to be lost. not cute. 😭

to avoid this — and this is specifically just between asynchronous invocations of rcvstore — always use it with an external locking mechanism. a procmailrc(5) local lockfile would work. or, if you're not using procmail, then consider dotlockfile(1) or flock(1). lock it up bestie, protect your peace 🫶

---

📂 FILES 📂

• $HOME/.mh_profile — The user profile

---

🧚 PROFILE COMPONENTS 🧚

• Path: — To determine the user's nmh directory
• Folder-Protect: — To set mode when creating a new folder
• Inbox: — To find the default inbox
• Msg-Protect: — To set mode when creating a new message
• Unseen-Sequence: — To name sequences denoting unseen messages

---

👑 SEE ALSO 👑

mh-sequence(5), procmailex(5), procmailrc(5), rcvdist(1), rcvpack(1), rcvtty(1)

---

💖 DEFAULTS 💖

• +folder defaults to the "Inbox" profile entry
• -create
• -unseen
• -nozero

---

🌈 CONTEXT 🌈

no context changes will be attempted, with the exception of sequence manipulation. that's it, that's the whole context situation. periodt. ✨

---

and that's the whole page, bestie!! this was nmh-1.8, dated 2013-02-19 — yes she's a little vintage, but vintage is just another word for iconic 💅💖 mwah, go file some mail 🦋🌸