Version: Next

vconnect - manpage

NAME

vconnect - connect to the tmux session of a netkit virtual machine.

SYNOPSIS

vconnect -m MACHINE-NAME --terminal --retry-count N --interval X

This will connect you to the tmux session of machine with name MACHINE-NAME, opening a new terminal as defined by TERM_TYPE in netkit.conf. If the tmux session does not initially exist it will try N times to connect, waiting X seconds between each attempt. After this it will exit

DESCRIPTION

The vconnect command connects you to the tmux session of a netkit virtual machine. You can connect either in your current shell, or in a new terminal.

OPTIONS

-h
--help

Print help message and exit. Other arguments will be ignored.

-l
--list

List all running sessions on the tmux 'netkit' server.

-t
--terminal

Connect to the tmux session from a new terminal. The terminal opened is dependent on the TERM_TYPE set in netkit.conf.

-m MACHINENAME
--machine MACHINENAME

Name of the netkit machine to connect to.

-r N
--retry-count N

If the first attempt to connect to the tmux session fails, retry N times.

-n X

--interval X

If the first attempt to connect to the tmux session fails, and retry-count is more than 1, sleep for X seconds between each attempt.

ENVIRONMENT VARIABLES

All Netkit commands require that the NETKIT_HOME variable contains the name of the directory Netkit is installed in.

Apart from this, vconnect supports no other environment variables.

SEE ALSO

vclean(1), vconf(1), vcrash(1), vhalt(1), vlist(1), vcommand(1), vstart(1).

AUTHOR

vconnect script: Billy Bromell
This man page: Billy Bromell

REPORTING BUGS

Report bugs to the Github issues page: https://github.com/netkit-jh/netkit-jh-build/issues

Please follow the recommended templates when reporting bugs.