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:
		| @@ -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. | ||||
|   | ||||
| @@ -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); | ||||
|   | ||||
| @@ -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'> | ||||
|   | ||||
| @@ -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'> | ||||
|   | ||||
		Reference in New Issue
	
	Block a user