X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcmds.texi;h=7d05bf2363ef8b8296f50aca81bcbaa3372a4c17;hb=2a5c56d7ba8cecf8f200255d5e5c61589c43009c;hp=ce0855a972db3c43334c86f44e7422a0f864de53;hpb=07a0344ed56852bf0570117e504c50e4152a3697;p=nncp.git diff --git a/doc/cmds.texi b/doc/cmds.texi index ce0855a..7d05bf2 100644 --- a/doc/cmds.texi +++ b/doc/cmds.texi @@ -18,11 +18,16 @@ Nearly all commands have the following common options: @item -nice Set desired outgoing packet @ref{Niceness, niceness level}. 1-255 values are allowed. +@item -replynice + Set desired reply packet @ref{Niceness, niceness level}. Only freq + and exec packets look at that niceness level. 1-255 values are + allowed. @item -node Process only single specified node. @item -via Override @ref{CfgVia, via} configuration option for destination node. Specified nodes must be separated with comma: @verb{|NODE1,NODE2|}. + With @verb{|-via -|} you can disable relaying at all. @item -spool Override path to spool directory. May be specified by @env{NNCPSPOOL} environment variable. @@ -233,6 +238,39 @@ time to time. can handle. @option{-bind} option specifies @option{addr:port} it must bind to and listen. +@node nncp-exec +@section nncp-exec + +@verbatim +% nncp-exec [options] NODE HANDLE [ARG0 ARG1 ...] +@end verbatim + +Send execution command to @option{NODE} for specified @option{HANDLE}. +Body is read from stdin and compressed. After receiving, remote side +will execute specified @ref{CfgExec, handle} command with @option{ARG*} +appended and decompressed body fed to command's stdin. + +For example, if remote side has following configuration file for your +node: + +@verbatim +exec: + sendmail: [/usr/sbin/sendmail, "-t"] + appender: ["/bin/sh", "-c", "cat >> /append"] +@end verbatim + +then executing @verb{|echo My message | nncp-exec -replynice 123 REMOTE +sendmail root@localhost|} will lead to executing of: + +@verbatim +echo My message | + NNCP_SELF=REMOTE \ + NNCP_SENDER=OurNodeId \ + NNCP_NICE=123 \ + /usr/sbin/sendmail -t root@localhost +@end verbatim + + @node nncp-file @section nncp-file @@ -295,19 +333,6 @@ queuing. Parse @ref{Log, log} file and print out its records in human-readable form. -@node nncp-mail -@section nncp-mail - -@verbatim -% nncp-mail [options] NODE USER ... -@end verbatim - -Send mail, that is read from stdin, to @option{NODE} and specified -@option{USER}s. Mail message will be compressed. After receiving, remote -side will execute specified @ref{CfgSendmail, sendmail} command with -@option{USER}s appended as a command line argument and feed decompressed -mail body to that command's stdin. - @node nncp-pkt @section nncp-pkt @@ -451,7 +476,14 @@ queues. @section nncp-toss @verbatim -% nncp-toss [options] [-dryrun] [-cycle INT] [-seen] +% nncp-toss [options] + [-dryrun] + [-cycle INT] + [-seen] + [-nofile] + [-nofreq] + [-nomail] + [-notrns] @end verbatim Perform "tossing" operation on all inbound packets. This is the tool @@ -471,6 +503,9 @@ successful tossing of @file{XXX} packet. @ref{nncp-xfer} and @ref{nncp-bundle} commands skip inbound packets that has been already seen, processed and tossed. This is helpful to defeat duplicates. +@option{-nofile}, @option{-nofreq}, @option{-nomail}, @option{-notrns} +options allow to disable any kind of packet types processing. + @node nncp-xfer @section nncp-xfer