TUNCTL(8) System Manager's Manual TUNCTL(8)NAME
tunctl -- create and manage persistent TUN/TAP interfaces
SYNOPSIS
tunctl [-f tun-clone-device] [-u owner] [-t device-name]
tunctl [-f tun-clone-device] -d device-name
DESCRIPTION
This manual page documents briefly the tunctl command.
This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. Instead, it
has documentation in HTML format; see below.
tunctl allows the host sysadmin to preconfigure a TUN/TAP device for use by a particular user. That user may open and use the device, but
may not change any aspects of the host side of the interface.
USAGE
To create an interface for use by a particular user, invoke tunctl without the -d option:
#
tunctl -u someuser
Set 'tap0' persistent and owned by 'someuser'
Then, configure the interface as normal:
#
ifconfig tap0 192.168.0.254 up
#
route add -host 192.168.0.253 dev tap0
#
bash -c 'echo 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp'
#
arp -Ds 192.168.0.253 eth0 pub
To delete the interface, use the -d option:
#
tunctl -d tap0
Set 'tap0' nonpersistent
SEE ALSO
The UserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html)
AUTHOR
tunctl was written by Jeff Dike jdike@karaya.com
This manual page was written by Matt Zimmerman mdz@debian.org for the Debian GNU/Linux system, based on examples from Jeff Dike.
TUNCTL(8)
Check Out this Related Man Page
UML_MCONSOLE(1) General Commands Manual UML_MCONSOLE(1)NAME
uml_mconsole -- attach to the management console of a user-mode Linux kernel
SYNOPSIS
uml_mconsole [socket] [command ...]
DESCRIPTION
This manual page documents briefly the uml_mconsole command.
This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.
uml_mconsole is a program to connect to the management console of a user-mode Linux kernel. The UML management console is a low-level
interface to the kernel, somewhat like the i386 SysRq interface. Since there is a full-blown operating system under UML, there is much
greater flexibility possible than with the SysRq mechanism.
OPTIONS
socket The pathname of the socket to which to connect. This is printed when UML boots, for example:
mconsole initialized on /tmp/umlNJ32yL/mconsole
In this example, you would start uml_mconsole like this:
uml_mconsole umlNJ32yL
command Any of the commands listed in the "COMMANDS" section.
COMMANDS
version Prints the UML version number.
halt Shuts down the UML system immediately, without syncing disks or cleanly shutting down swap space.
reboot Reboots the UML system immediately, without syncing disks or cleanly shutting down swap space.
log string
Cause UML to log string to the kernel log.
cad Invokes the Control-Alt-Delete handler.
sysrq letter
Performs the SysRq action controlled by letter.
stop Pauses UML. UML will do nothing until the 'go' command is issued.
go Resumes execution after a 'stop' command.
config device
Adds a new device to the virtual machine, or queries the configuration of an existing device. It takes one argument, which is
either the device to add, with the same syntax as the kernel command line, or the name of an existing device. For example:
(mconsole)
config ubd3=root_fs_debian22
OK
(mconsole)
config ubd3
OK root_fs_debian22
remove Deletes a device from the virtual machine. Its argument is the name of the device to be removed. In the case of the ubd driver,
the removed block device must not be mounted, swapped on, or otherwise open, and in the case of the network driver, the device
must be down.
(mconsole)
remove ubd3
OK
SEE ALSO linux(1)
The UserModeLinux-HOWTO (link to URL http://user-mode-linux.sourceforge.net/UserModeLinux-HOWTO.html)
AUTHOR
uml_mconsole was written by Jeff Dike and others.
This manual page was written by Matt Zimmerman mdz@debian.org for the Debian GNU/Linux system, based on material in the UserModeLinux-HOWTO
by Rusty Russell, and the uml_mconsole source code.
UML_MCONSOLE(1)