NAME

       vznnc - run a program connected to a socket

SYNOPSIS

       vznnc { -l | -c } -p port [-f fd] [--] program [arg ...]

DESCRIPTION

       This "nano-netcat" utility can be used to either listen on or connect to a TCP port at
       localhost, and run a specified program with its stdin and stdout (or a specified file
       descriptor) connected to the socket.

OPTIONS

       -l     Listen on a specified TCP port at localhost.

       -c     Connect to a specified TCP port at localhost.

       -p port
              Port number.

       -f fd  File descriptor ID. If this option is not set, stdin and stdout are closed and are
              connected to the socket, otherwise they are left intact, and the specified fd is
              used.

       --     This is a separator between vznnc own arguments and program arguments, so that
              latter won't be processed by vznnc.  It is required in case there are any arguments
              to program that start with the dash (-) character, and is optional otherwise.

       program [ arg ... ]
              Program to run, with optional arguments.

EXIT STATUS

       Returns program exit status upon success, or one of the following codes in case of an
       error:

       1      Invalid usage

       127    Error executing program.

       220    Network-related error.

EXAMPLES

       To run receiving side of ploop copy command on a remote server, using openssh port
       forwarding:

        PORT=2345
        ssh -L localhost:$PORT:localhost:$PORT $REMOTE_SERVER \
            vznnc -l -p $PORT -- ploop copy -d $FILE -i0 -o1

       To do the same, but with stdin and stdout intact, using file descriptor 5 for
       communication:

        ssh -L localhost:$PORT:localhost:$PORT $REMOTE_SERVER \
            vznnc -l -p $PORT -f 5 -- ploop copy -d $FILE -i5 -o5

SEE ALSO

       nc(3), netcat(3), socat(2).

LICENSE

       Copyright (C) 2014, Parallels, Inc. Licensed under GNU GPL v2.