1lxc-user-nic(1)                                                lxc-user-nic(1)
2
3
4

NAME

6       lxc-user-nic - Create and attach a nic to another network namespace.
7

SYNOPSIS

9       lxc-user-nic {pid} {type} {bridge} [nicname]
10

DESCRIPTION

12       lxc-user-nic is a setuid-root program with which unprivileged users may
13       create network interfaces for use by a lxc container.
14
15       It will consult the configuration file /etc/lxc/lxc-usernet  to  deter‐
16       mine the number of interfaces which the calling user is allowed to cre‐
17       ate, and which bridge he may attach them to. It tracks  the  number  of
18       interfaces  each  user has created using the file /run/lxc/nics. It en‐
19       sures that the calling user is privileged over the network namespace to
20       which the interface will be attached.
21

OPTIONS

23       pid    The  process  id for the task to whose network namespace the in‐
24              terface should be attached.
25
26       type   The network interface type to attach.  Currently  only  veth  is
27              supported. With this type, two interfaces representing each tun‐
28              nel endpoint are created. One endpoint will be attached  to  the
29              specified  bridge,  while the other will be passed into the con‐
30              tainer.
31
32       bridge The bridge to which to attach the  network  interface,  for  in‐
33              stance lxcbr0.
34
35       nicname
36              The  desired  interface name in the container. This will be eth0
37              if unspecified.
38

SEE ALSO

40       lxc(1), lxc-start(1), lxc-usernet(5)
41

AUTHOR

43       Daniel Lezcano <daniel.lezcano@free.fr>
44
45
46
47                                  2018-11-23                   lxc-user-nic(1)