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.

       A traditional UNIX-style server such as ftpd handles just one network connection,  reading
       input  from stdin and writing output to stdout. A "superserver" such as inetd or tcpserver
       listens for network connections and starts a separate server process for each connection.

       The CurveCP command-line tools have  an  extra  level  of  modularity.  The  curvecpserver
       superserver listens for network connections. For each connection, curvecpserver starts the
       curvecpmessage message handler; curvecpmessage then starts a server such  as  ftpd.   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.  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.   The  same  curvecpmessage  tool  is  also  used by
       curvecpclient.

       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.

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

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
       http://curvecp.org/messageapi.html  .   Permission  is  granted to copy, distribute and/or
       modify this document under public domain.

       This manual page was rewritten for the Debian distribution because  the  original  program
       does not have a manual page.

                                                                                          NaCl(1)