Document the semantic of ranges.

* libmisc/idmapping.h: Document what the upper and lower fields
	are in struct map_range.
	* man/newgidmap.1.xml: Document when the gid, gidlower and count
	argument are.
	* man/newuidmap.1.xml: Likewise for uid, uidlower and count.
This commit is contained in:
Nicolas François 2013-08-13 19:28:07 +02:00
parent 5884ba907c
commit e1a4b6e57b
4 changed files with 69 additions and 3 deletions

View File

@ -1,3 +1,11 @@
2013-08-13 Nicolas François <nicolas.francois@centraliens.net>
* libmisc/idmapping.h: Document what the upper and lower fields
are in struct map_range.
* man/newgidmap.1.xml: Document when the gid, gidlower and count
argument are.
* man/newuidmap.1.xml: Likewise for uid, uidlower and count.
2013-08-13 Nicolas François <nicolas.francois@centraliens.net>
* libmisc/salt.c (shadow_random): Use long instead of size_t.

View File

@ -31,9 +31,9 @@
#define _IDMAPPING_H_
struct map_range {
unsigned long upper;
unsigned long lower;
unsigned long count;
unsigned long upper; /* first ID inside the namespace */
unsigned long lower; /* first ID outside the namespace */
unsigned long count; /* Length of the inside and outside ranges */
};
extern struct map_range *get_map_ranges(int ranges, int argc, char **argv);

View File

@ -87,6 +87,35 @@
command line arguments and the gids allowed in <filename>/etc/subgid</filename>.
</para>
<para>
After the pid argument, <command>newgidmap</command> expects sets of 3 integers:
<variablelist>
<varlistentry>
<term>gid</term>
<listitem>
<para>
Begining of the range of GIDs inside the user namespace.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>lowergid</term>
<listitem>
<para>
Begining of the range of GIDs outside the user namespace.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>count</term>
<listitem>
<para>
Length of the ranges (both inside and outside the user namespace).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id='options'>

View File

@ -84,6 +84,35 @@
command line arguments and the uids allowed in <filename>/etc/subuid</filename>.
</para>
<para>
After the pid argument, <command>newuidmap</command> expects sets of 3 integers:
<variablelist>
<varlistentry>
<term>uid</term>
<listitem>
<para>
Begining of the range of UIDs inside the user namespace.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>loweruid</term>
<listitem>
<para>
Begining of the range of UIDs outside the user namespace.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>count</term>
<listitem>
<para>
Length of the ranges (both inside and outside the user namespace).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 id='options'>