bionic (1) lxc-user-nic.1.gz

Provided by: lxc-utils_3.0.3-0ubuntu1~18.04.3_amd64 bug

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>

                                                   2023-05-05                                    lxc-user-nic(1)