Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   33470 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 interfaces for use by a lxc container.

       It will consult the configuration file /etc/lxc/lxc-usernet  to	deter‐
       mine the number of interfaces which the calling user is allowed to cre‐
       ate, 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 tun‐
	      nel endpoint are created. One endpoint will be attached  to  the
	      specified	 bridge,  while the other will be passed into the con‐
	      tainer.

       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 /container.

       -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>

			  Thu Jul 3 13:01:56 PDT 2014	       LXC-USER-NIC(1)

Vote for polarhome