[OE-core] [PATCH 1/4] documentation.conf: Add information about USERADD varaibles

[Mark Hatle]

On 6/17/16 8:41 AM, Peter Kjellerstedt wrote:
> Signed-off-by: Peter Kjellerstedt <peter.kjellerstedt at axis.com>
> ---
>  meta/conf/documentation.conf | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/meta/conf/documentation.conf b/meta/conf/documentation.conf
> index c0025f5..38639d5 100644
> --- a/meta/conf/documentation.conf
> +++ b/meta/conf/documentation.conf
> @@ -452,8 +452,12 @@ UBOOT_SUFFIX[doc] = "Points to the generated U-Boot extension."
>  UBOOT_TARGET[doc] = "Specifies the target used for building U-Boot."
>  USE_DEVFS[doc] = "When building images, specifies to populate or not /dev. This variable defaults to '1' (leave directory empty, surely because devtmpfs do the job). Set it to '0' to use makedevs (or consider using a custom file with IMAGE_DEVICE_TABLES)."
>  USER_CLASSES[doc] = "List of additional classes to use when building images that enable extra features."
> +USERADD_ERROR_DYNAMIC[doc] = "Forces the OpenEmbedded build system to produce an error if the user identification (uid) and group identification (gid) values are not defined in files/passwd and files/group files."

I think the description is incorrect.  Specifically:

...values are not defined in files/passwd and files/group files.

should be

...values are not defined in the USERADD_UID_TABLES and USERADD_GID_TABLES.

> +USERADD_GID_TABLES[doc] = "Specifies a password file to use for obtaining static group identification (gid) values when the OpenEmbedded build system adds a group to the system during package installation."
>  USERADD_PACKAGES[doc] = "When a recipe inherits the useradd class, this variable specifies the individual packages within the recipe that require users and/or groups to be added."
>  USERADD_PARAM[doc] = "When a recipe inherits the useradd class, this variable specifies for a package what parameters should be passed to the useradd command if you wish to add a user to the system when the package is installed."
> +USERADD_UID_TABLES[doc] = "Specifies a password file to use for obtaining static user identification (uid) values when the OpenEmbedded build system adds a user to the system during package installation."
> +USERADDEXTENSION[doc] = "When set to 'useradd-staticids', causes the OpenEmbedded build system to base all user and group additions on a static passwd and group files found in BBPATH."

again, here I think we need to clarify "static passwd and group" to refer to the
USERADD_UID_TABLES and USERADD_GID_TABLES or someone might not understand that
is what is needed.

>  
>  #W
>  
>