Provided by: lxc_1.0.3-0ubuntu3_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.

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@free.fr>

                                   Mon Apr 14 15:49:22 UTC 2014                   lxc-user-nic(1)