1NaCl(1)                     General Commands Manual                    NaCl(1)
2
3
4

NAME

6       CurveCP — Message-handling programs
7

SYNOPSIS

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

DESCRIPTION

13       This manual page documents briefly the CurveCP commands.
14
15       A traditional UNIX-style server such as ftpd handles just  one  network
16       connection,  reading  input  from stdin and writing output to stdout. A
17       "superserver" such as inetd or tcpserver listens  for  network  connec‐
18       tions and starts a separate server process for each connection.
19
20       The  CurveCP  command-line tools have an extra level of modularity. The
21       curvecpserver  superserver listens for network  connections.  For  each
22       connection,  curvecpserver  starts  the curvecpmessage message handler;
23       curvecpmessage then starts a server such as ftpd.  Then  ftpd  sends  a
24       stream  of  data  to  curvecpmessage,  which  in turn sends messages to
25       curvecpserver, which encrypts and authenticates the messages and  sends
26       them  inside  network  packets. At the same time curvecpclient receives
27       network packets, verifies and decrypts messages inside the packets, and
28       passes the messages to curvecpmessage; curvecpmessage sends a stream of
29       data to ftpd.  The same curvecpmessage tool is also  used  by  curvecp‐
30       client.
31
32       curvecpserver and curvecpclient can use programs other than curvecpmes‐
33       sage. Those programs can directly generate messages in the CurveCP mes‐
34       sage format without talking to separate tools such as ftpd; or they can
35       support a completely different protocol that reuses  CurveCP's  crypto‐
36       graphic layer but transmits different kinds of messages.
37

OPTIONS

39       How to use curvecpmessage:
40
41       -q           optional
42                 no error messages
43
44       -Q           optional
45                 print error messages (default)
46
47       -v           optional
48                 print extra information
49
50       -c           optional
51                 program is a client; server starts first
52
53       -C           optional
54                 program is a client that starts first
55
56       -s           optional
57                 program is a server (default)
58
59       prog      run this server
60

SEE ALSO

62       curvecpserver (1), curvecpclient (1), inetd (8), tcpserver (1).
63

AUTHOR

65       This  manual  page  was  written  by  Sergiusz Pawlowicz debian@pawlow‐
66       icz.name for the Debian system (and may be used by others). The  source
67       of this page is a webpage http://curvecp.org/messageapi.html .  Permis‐
68       sion is granted to copy, distribute and/or modify this  document  under
69       public domain.
70
71
72       This  manual page was rewritten for the Debian distribution because the
73       original program does not have a manual page.
74
75
76
77                                                                       NaCl(1)
Impressum