View source for Umview+UMlwip

Umview starts the first process running inside the (partial) virtual machine.
This process and all its offspring run under the control of umview.

The command:
<pre>
$ umview xterm
</pre>
starts an xterm running inside the virtual machine. It is possible to use ''rxvt'' or ''bash'' instead of ''xterm''.

Before loading any module umview does nothing. Processes running inside the umview machine behave in the same way of all the others processes.

=== lwipv6 ===

'''NOTICE.''' umlwip is being replaced by the '''umnetlwipv6''' submodule of '''umnet''', and '''umlwip is now deprecated'''. Until this page gets updated, please read the pages about [[UMNET:_user_mode_virtual_multi_stack_support|umnet]] and the [[UMNET_modules|umnet modules]] for more information about the new implementation.

The ''lwipv6'' module creates virtual interfaces based on the liblwipv6 TCP-IP user mode stack.

The simplest way to start it is:
<pre>
$ um_add_service lwipv6
$ ip addr
1: lo0: <LOOPBACK,UP> mtu 0 
    link/loopback 
    inet6 ::1/128 scope host 
    inet 127.0.0.1/8 scope host 
2: vd0: <BROADCAST> mtu 1500 
    link/ether 02:02:38:bd:cd:06 brd ff:ff:ff:ff:ff:ff
$
</pre>

The output of the ''ip'' command shows the default interfaces defined by lwipv6: ''lo0'' i.e. localhost and
a vde interface. (we support ''ip'' for network configuration instead of ''ifconfig'' because ''ip'' has a
complete and consistent management of IPv6 multiple addresses and it is based on the portable AF_NETLINK
interface. ''ifconfig'' instead uses /proc to read info. ''ip'' is usually part of the ''iproute'' packet).

Lwipv6 is able to create several interfaces connected to different vde switches, to tun or tap interfaces.

The following commands:
<pre>
$ um_add_service lwipv6,vd0=/tmp/v1
$ um_add_service lwipv6,vd0=/tmp/v1,vd1=tmp/v2
$ um_add_service lwipv6,vd0=/tmp/v1,tp0=tap2,tn0=tun2
</pre>
# attach a vde interface to a specific switch;
# create two vde interfaces connected to two different switches;
# create a vde, a tap and a tun interface;
respectively.

In the latter case the user must have the permissions to create virtual interfaces. For kernels 2.6.18 and above
this means that the system administrator must have already created the interfaces in advance in this way:
<pre>
# tunctl -u username -t tap2
# tunctl -u username -t tun2
</pre>

=== Setting IP addresses ===

Lwipv6 interfaces can be configured using the ''ip'' command like any other interface. Virtual interfaces start in 
''down'' state, thus they must be activated.

<pre>
$ ip link set vd0 up
$ ip addr add 192.168.1.1/24 dev vd0
</pre>

Lwipv6 supports ipv6 autoconfiguration, thus if there is a radv server running on the virtual network the interface get automagically configured.

It is also possible to run a dhcp client.

For example this is the command to set up a vde interface using the udhcpc tool: 
<pre>
$ ip link set vd0 up
$ /sbin/udhcpc -i vd0 -q -s ~/etc/udhcpc/default.script
udhcpc (v0.9.9-pre) started
Nothing to flush.
Nothing to flush.
Sending discover...
Sending select for 192.168.1.1...
Lease of 192.168.1.1 obtained, lease time 600
Nothing to flush.
Nothing to flush.
adding dns 192.168.1.254
$
</pre>

The contents of the ~/etc/udhcpc directory can be downloaded here: [[Media:udhcpc.tar.bz2|udhcpc.tar.bz2]]