Man/vznnc.8

From OpenVZ Virtuozzo Containers Wiki
< Man
Jump to: navigation, search

NAME[edit]

vznnc − run a program connected to a socket

SYNOPSIS[edit]

vznnc

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

DESCRIPTION[edit]

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[edit]

-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[edit]

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[edit]

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[edit]

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

LICENSE[edit]

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