NAME

       lxc-user-nic - Create and attach a nic to another network namespace.

SYNOPSIS

       lxc-user-nic {pid} {type} {bridge} [nicname]

DESCRIPTION

       lxc-user-nic  is  a  setuid-root  program with which unprivileged users may create network
       interfaces for use by a lxc container.

       It will consult the configuration file /etc/lxc/lxc-usernet to  determine  the  number  of
       interfaces  which  the  calling  user is allowed to create, and which bridge he may attach
       them to. It tracks the  number  of  interfaces  each  user  has  created  using  the  file
       /run/lxc/nics.  It  ensures that the calling user is privileged over the network namespace
       to which the interface will be attached.

OPTIONS

       pid    The process id for the task to whose network  namespace  the  interface  should  be
              attached.

       type   The  network  interface type to attach. Currently only veth is supported. With this
              type, two interfaces representing each tunnel endpoint are  created.  One  endpoint
              will  be  attached to the specified bridge, while the other will be passed into the
              container.

       bridge The bridge to which to attach the network interface, for instance lxcbr0.

       nicname
              The desired interface name in the container. This will be eth0 if unspecified.

SEE ALSO

       lxc(1), lxc-start(1), lxc-usernet(5)

AUTHOR

       Daniel Lezcano <daniel.lezcano@free.fr>

                                            2017-08-01                            lxc-user-nic(1)