df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn<!--
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynlxc: linux Container library
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn(C) Copyright Canonical Ltd. 2013
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynAuthors:
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynSerge Hallyn <serge.hallyn@ubuntu.com>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynThis library is free software; you can redistribute it and/or
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynmodify it under the terms of the GNU Lesser General Public
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynLicense as published by the Free Software Foundation; either
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynversion 2.1 of the License, or (at your option) any later version.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynThis library is distributed in the hope that it will be useful,
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynbut WITHOUT ANY WARRANTY; without even the implied warranty of
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynLesser General Public License for more details.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynYou should have received a copy of the GNU Lesser General Public
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynLicense along with this library; if not, write to the Free Software
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn-->
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn<!DOCTYPE refentry PUBLIC @docdtd@ [
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn]>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn<refentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refmeta>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refentrytitle>lxc-usernet</refentrytitle>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <manvolnum>5</manvolnum>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refmeta>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refnamediv>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refname>lxc-usernet</refname>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refpurpose>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn unprivileged user network administration file.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refpurpose>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refnamediv>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <title>Description</title>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <filename>@LXC_USERNIC_CONF@</filename> controls the limits which the
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn program <command>lxc-user-nic</command> places on network interfaces
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn which an unprivileged user may create.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refsect2>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <title>Configuration</title>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn This file consists of multiple entries, one per line, of the form:
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <command>user</command> <command>type</command> <command>bridge</command> <command>number</command>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <para>or</para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <command>@group</command> <command>type</command> <command>bridge</command> <command>number</command>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn Where
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <variablelist>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <option>user</option>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn is the username to whom this entry applies.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <varlistentry>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <term>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <option>@group</option>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </term>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <listitem>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede is the groupname to which this entry applies.
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </listitem>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </varlistentry>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <option>type</option>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn is the type of network interface being allowed. Only veth
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn is currently supported.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <option>bridge</option>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn is the bridge to which the network interfaces may be attached, for
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn instance <filename>lxcbr0</filename>.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <option>number</option>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </term>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede is the number or quota of network interfaces of the given type which the
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede given user or group may attach to the given bridge, for instance <filename>2</filename>.
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </listitem>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </varlistentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </variablelist>
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede <para>
b0c80583231d50bc05c2be34c999e5f29843d478KATOH Yasufumi Since a user can be specified both by username as well as one or
21002b3950923d0a283d74af51cf5908c1af579bHenrik Kjölhede more usergroups, it is possible that several configuration lines
21002b3950923d0a283d74af51cf5908c1af579bHenrik Kjölhede enable that user to create network interfaces. In such cases, any
21002b3950923d0a283d74af51cf5908c1af579bHenrik Kjölhede interfaces create are counted towards the quotas of the user or group
21002b3950923d0a283d74af51cf5908c1af579bHenrik Kjölhede in the order in which they appear in the file. If the quota of one
21002b3950923d0a283d74af51cf5908c1af579bHenrik Kjölhede line is full, the rest will be parsed until one is found or the end of
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede the file.
1940bff4d299fcc96966ee5878c3e604666a8c39Henrik Kjölhede </para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refsect2>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <title>See Also</title>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <simpara>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <citerefentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refentrytitle><command>lxc</command></refentrytitle>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <manvolnum>1</manvolnum>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </citerefentry>,
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <citerefentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refentrytitle><command>lxc-user-nic</command></refentrytitle>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <manvolnum>1</manvolnum>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </citerefentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </simpara>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <title>Author</title>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn </refsect1>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn</refentry>
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn<!-- Keep this comment at the end of the file
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynLocal variables:
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynmode: sgml
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-omittag:t
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-shorttag:t
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-minimize-attributes:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-always-quote-attributes:t
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-indent-step:2
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-indent-data:t
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-parent-document:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-default-dtd-file:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-exposed-tags:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-local-catalogs:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallynsgml-local-ecat-files:nil
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge HallynEnd:
df3415e02282317348bbd5f9ce66d03e1c81eeecSerge Hallyn-->