lxc-user-nic(1)                                                                   lxc-user-nic(1)



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 in‐
       terfaces for use by a lxc container.

       It will consult the configuration file /etc/lxc/lxc-usernet to determine the number of in‐
       terfaces  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 in‐
       terface will be attached.

OPTIONS
       pid    The process id for the task to whose network namespace the interface should be  at‐
              tached.

       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.

COMMON OPTIONS
       These options are common to most of lxc commands.

       -?, -h, --help
              Print a longer usage message than normal.

       --usage
              Give the usage message

       -q, --quiet
              mute on

       -P, --lxcpath=PATH
              Use an alternate container path. The default is /var/lib/lxc.

       -o, --logfile=FILE
              Output to an alternate log FILE. The default is no log.

       -l, --logpriority=LEVEL
              Set log priority to LEVEL. The default log priority is ERROR. Possible values are :
              FATAL, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG.

              Note  that  this  option is setting the priority of the events log in the alternate
              log file. It do not have effect on the ERROR events log on stderr.

       -n, --name=NAME
              Use container identifier NAME.  The container identifier format is an  alphanumeric
              string.

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

AUTHOR
       Daniel Lezcano <daniel.lezcano AT free.fr>



                                   Sat Apr 29 06:45:43 UTC 2017                   lxc-user-nic(1)