NaCl(1)

💖 NaCl(1) — CurveCP 💖

okay bestie, this is the manual page for CurveCP — message-handling programs, and it lives in the General Commands Manual section. yes it's under the name NaCl and yes that's the whole vibe. let's go ✨

---

🌸 NAME 🌸

CurveCP — message-handling programs 🫶

---

✨ SYNOPSIS ✨

curvecpmessage [-q (optional)]  [-Q (optional)]  [-v (optional)]  [-c
(optional)]  [-C (optional)]  [-s (optional)]  [prog]

---

🦋 DESCRIPTION 🦋

This manual page documents briefly the CurveCP commands. short and sweet, we love that for us 💅

So picture a traditional UNIX-style server, right? something like ftpd. it handles literally one network connection: reads input from stdin, writes output to stdout, done, no thoughts. then there's a "superserver" like inetd or tcpserver — that one listens for network connections and starts a separate server process for each and every connection. iconic behaviour, honestly 👑

The CurveCP command-line tools have an extra level of modularity, and that's the whole plot twist. let's break it down:

• The curvecpserver superserver listens for network connections. that's its job, it's the listener, main character energy ✨
• For each connection, curvecpserver starts the curvecpmessage message handler. so it's like, the superserver hands things off to the message handler.
• curvecpmessage then starts a server such as ftpd. nesting doll situation, we love to see it 🪆
• Then ftpd sends a stream of data to curvecpmessage, which in turn sends messages to curvecpserver, which encrypts and authenticates the messages and sends them inside network packets. okay so that's the outbound journey, got it 🚀
• At the same time curvecpclient receives network packets, verifies and decrypts messages inside the packets, and passes the messages to curvecpmessage; curvecpmessage sends a stream of data to ftpd. and that's the inbound journey, symmetry, we love it 💖

And the same curvecpmessage tool is also used by curvecpclient. one tool, two besties, no cap.

okay and here's a fun fact — curvecpserver and curvecpclient can use programs other than curvecpmessage. those programs can directly generate messages in the CurveCP message format without talking to separate tools such as ftpd; or they can support a completely different protocol that reuses CurveCP's cryptographic layer but transmits different kinds of messages. so flexible. so modular. lowkey genius 🧚

---

🎀 OPTIONS 🎀

How to use curvecpmessage:

• -q — optional. no error messages 🙈
• -Q — optional. print error messages (default) 💬
• -v — optional. print extra information 👀
• -c — optional. program is a client; server starts first
• -C — optional. program is a client that starts first
• -s — optional. program is a server (default) 🫡
• prog — run this server

ngl, -Q and -s are the defaults, so if you just roll up with nothing, that's what you're getting. periodt 💅

---

🌈 SEE ALSO 🌈

• curvecpserver (1)
• curvecpclient (1)
• inetd (8)
• tcpserver (1)

---

👑 AUTHOR 👑

This manual page was written by Sergiusz Pawlowicz debian@pawlowicz.name for the Debian system (and may be used by others). the source of this page is a webpage https://curvecp.org/messageapi.html. Permission is granted to copy, distribute and/or modify this document under public domain. fr fr, take it, it's yours 🫶

This manual page was rewritten for the Debian distribution because the original program does not have a manual page. not me fixing the docs situation 😭💖

---

and that's the whole page bestie!! this was NaCl(1) from the General Commands Manual, and you're all caught up on CurveCP now. slay, go encrypt something 💖✨🎀🦋🌸💅🫶