lxc-usernet.sgml.in revision 21002b3950923d0a283d74af51cf5908c1af579b
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainenlxc: linux Container library
e015e2f7e7f48874495f9df8b0dd192b7ffcb5ccTimo Sirainen(C) Copyright Canonical Ltd. 2013
1098fc409a45e7603701dc94635927a673bee0c1Timo SirainenSerge Hallyn <serge.hallyn@ubuntu.com>
18d92dbbb752c79dc461514e52f7ef11847e636bTimo SirainenThis library is free software; you can redistribute it and/or
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainenmodify it under the terms of the GNU Lesser General Public
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenLicense as published by the Free Software Foundation; either
e9594e86dc601b72c1636f2b901dcfbf4ffaf47fAki Tuomiversion 2.1 of the License, or (at your option) any later version.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenThis library is distributed in the hope that it will be useful,
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainenbut WITHOUT ANY WARRANTY; without even the implied warranty of
ab1e5b156d1b5480d36ed6e8e06197339d803038Timo SirainenMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
ab1e5b156d1b5480d36ed6e8e06197339d803038Timo SirainenLesser General Public License for more details.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenYou should have received a copy of the GNU Lesser General Public
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo SirainenLicense along with this library; if not, write to the Free Software
e8fd7988ec183fb6c104aed19a61f1a096c51d34Timo SirainenFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
fafa6393128960c70a9979af1c23cea41027fdd1Josef 'Jeff' Sipek<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen unprivileged user network administration file.
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen </refpurpose>
19e8adccba16ff419f5675b1575358c2956dce83Timo Sirainen </refnamediv>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen <filename>@LXC_USERNIC_CONF@</filename> controls the limits which the
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen program <command>lxc-user-nic</command> places on network interfaces
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen which an unprivileged user may create.
846624bdec0d5deec6cf22071158221391ec5f2dAki Tuomi This file consists of multiple entries, one per line, of the form:
846624bdec0d5deec6cf22071158221391ec5f2dAki Tuomi <command>user</command> <command>type</command> <command>bridge</command> <command>number</command>
846624bdec0d5deec6cf22071158221391ec5f2dAki Tuomi <command>@group</command> <command>type</command> <command>bridge</command> <command>number</command>
846624bdec0d5deec6cf22071158221391ec5f2dAki Tuomi <variablelist>
846624bdec0d5deec6cf22071158221391ec5f2dAki Tuomi <varlistentry>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen is the username to whom this entry applies.
1098fc409a45e7603701dc94635927a673bee0c1Timo Sirainen </varlistentry>
5bd1c1d4fe3265d5e6b6054044fd6d78e42c9d0aTimo Sirainen <varlistentry>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen is the groupname to which this entry applies.
d9fdacd5fb3e07997e5c389739d2054f0c8441d8Timo Sirainen </varlistentry>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen <varlistentry>
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen is the type of network interface being allowed. Only veth
0cb2e8eb55e70f8ebe1e8349bdf49e4cbe5d8834Timo Sirainen is currently supported.
abe7afb8f1766fbcef1b9df513109e43d7d16e49Timo Sirainen </varlistentry>
ab70f55bb8d824ca1ed7c74196f2f502edd29cc7Timo Sirainen <varlistentry>
ab70f55bb8d824ca1ed7c74196f2f502edd29cc7Timo Sirainen is the bridge to which the network interfaces may be attached, for
2131ef7a3390f15ea6a958256ea54908f1096350Timo Sirainen </varlistentry>
abe7afb8f1766fbcef1b9df513109e43d7d16e49Timo Sirainen <varlistentry>
f330b7d9e14255fc06bc82908d9bc5a12cccb424Timo Sirainen is the number or quota of network interfaces of the given type which the
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen given user or group may attach to the given bridge, for instance <filename>2</filename>.
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen </varlistentry>
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen </variablelist>
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen Since a user can be be specified both by username as well as one or
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen more usergroups, it is possible that several configuration lines
f330b7d9e14255fc06bc82908d9bc5a12cccb424Timo Sirainen enable that user to create network interfaces. In such cases, any
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen interfaces create are counted towards the quotas of the user or group
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen in the order in which they appear in the file. If the quota of one
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen line is full, the rest will be parsed until one is found or the end of
f330b7d9e14255fc06bc82908d9bc5a12cccb424Timo Sirainen <citerefentry>
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen <refentrytitle><command>lxc</command></refentrytitle>
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen </citerefentry>,
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen <citerefentry>
620b5ed41650da63b0ba15c489f9f312231d5d9bTimo Sirainen <refentrytitle><command>lxc-user-nic</command></refentrytitle>
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainen </citerefentry>
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainen <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainen<!-- Keep this comment at the end of the file
69e03a846f6980144aa75bff0590c04852bffbbcTimo SirainenLocal variables:
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-omittag:t
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-shorttag:t
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-minimize-attributes:nil
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-always-quote-attributes:t
66ecc94150cbce23aad3240135e0782e0a74d479Timo Sirainensgml-indent-step:2
bc564f1d3d953cf724828322b11ae89e0f59ffc9Timo Sirainensgml-indent-data:t
04b8a90af181cc4c7959266855e8ed50a22ed413Timo Sirainensgml-parent-document:nil
bc564f1d3d953cf724828322b11ae89e0f59ffc9Timo Sirainensgml-default-dtd-file:nil
2131ef7a3390f15ea6a958256ea54908f1096350Timo Sirainensgml-exposed-tags:nil
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-local-catalogs:nil
69e03a846f6980144aa75bff0590c04852bffbbcTimo Sirainensgml-local-ecat-files:nil