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 privi‐
       leged 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 inter‐
              faces  representing  each tunnel endpoint are created. One endpoint will be attached to the speci‐
              fied 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)