NAME

       mstack - networking stack selection

SYNOPSIS

       mstack [-hv] [-o protocol list] stack_mountpoint command

DESCRIPTION

       In View-OS multiple networking stacks are available to processes at the same time. View-OS
       supports the msocket(2) system call.  mstack defines the default stack (for  each  address
       family)  that  is  used  when  msocket  refers  to  a NULL pathname for its stack.  mstack
       provides also a backward compatibility for all the programs using the  obsolete  socket(2)
       system  call.   The  stack mountpoint identifies the stack. In ViewOS it is the mountpoint
       where the stack was mounted (by mount(2)(8).  In fact the call:
       "socket(domain,type,protocol)"
       is equivalent to:
       "msocket(NULL,domain,type protocol)"
       mstacks changes the default stack for the  desired  protocol  families  and  executes  the
       command (by execve(2)).

OPTIONS

       -h  prints the mstack command usage

       -v  sets the verbose mode on

       -o  defines the list of protocols. Without a -o option, mstack redefines the default stack
           for all protocols families.  The list of protocols may include the a  comma  separated
           sequence  of the following items: all, unix (or simply u), ipv4 (4), ipv6 (6), netlink
           (n), packet (p), bluetooth (b), irda (i), ip (which include all ip  related  protocols
           ipv4,  ipv6, netlink and packet), #n where n is the number of protocol.  Each item can
           be prefixed by + or - to specify whether the protocol/group of protocols must be added
           or removed from the set.

EXAMPLES

       mstack /dev/net/lwip ip addr
              lists the address managed by the stack mounted on /dev/net/lwip.

       exec mstack /dev/net/null bash
              disables the standard stack in a new bash (which overcomes the current one).

       mstack -o ip /dev/net/lwip bash
              starts  a new bash which uses the stack /dev/net/lwip for ipv4 and ipv6 but not for
              the other protocols.

       mstack -o -unix /dev/net/lwip bash
              starts a new bash which uses the stack /dev/net/lwip for all protocols but AF_UNIX.

       mstack -o +ip,-ipv6 /dev/net/lwip bash
              starts a new bash which uses the stack /dev/net/lwip for ipv4, netlink, packet  but
              not ipv6.

SEE ALSO

       umview(1),  kmview(1),  msocket(3), umnetnative(9), umnetnull(9), umnetlwipv6(9), unix(7),
       ip(7), ipv6(7), netlink(7), packet(7).

AUTHORS

       View-OS is a project of the Computer Science Department, University  of  Bologna.  Project
       Leader: Renzo Davoli.
       <http://www.sourceforge.net/projects/view-os>

       Howto's and further information can be found on the project wiki <wiki.virtualsquare.org>.