extrausers.bbclass: add a new bbclass

This class is dedicated to image level user/group configuration.
It inherits useradd_base.bbclass.

Users need to inherit this class in their layers or local.conf to
make the setting of EXTRA_USERS_PARAMS effective.

For detailed configuration format of EXTRA_USERS_PARAMS, please
refer to local.conf.sample.extended.

[YOCTO #4074]

(From OE-Core rev: 4b6deb521183b728d9a1c651d4805fe635e6cb50)

Signed-off-by: Chen Qi <Qi.Chen@windriver.com>
Signed-off-by: Saul Wold <sgw@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

diff --git a/meta/classes/extrausers.bbclass b/meta/classes/extrausers.bbclass
new file mode 100644 (file)
index 0000000..8670a2a
--- /dev/null
+++ b/meta/classes/extrausers.bbclass
@@ -0,0 +1,61 @@
+# This bbclass is mainly used for image level user/group configuration.
+# Inherit this class if you want to make EXTRA_USERS_PARAMS effective.
+
+# Below is an example showing how to use this functionality.
+# INHERIT += "extrausers"
+# EXTRA_USERS_PARAMS = "\
+# useradd -p '' tester; \
+# groupadd developers; \
+# userdel nobody; \
+# groupdel -g video; \
+# groupmod -g 1020 developers; \
+# usermod -s /bin/sh tester; \
+# "
+
+
+inherit useradd_base
+
+IMAGE_INSTALL_append = " ${@['', 'base-passwd shadow'][bool(d.getVar('EXTRA_USERS_PARAMS', True))]}"
+
+# Image level user / group settings
+ROOTFS_POSTPROCESS_COMMAND_append = " set_user_group;"
+
+# Image level user / group settings
+set_user_group () {
+       user_group_settings="${EXTRA_USERS_PARAMS}"
+       export PSEUDO="${FAKEROOTENV} ${STAGING_DIR_NATIVE}${bindir}/pseudo"
+       setting=`echo $user_group_settings | cut -d ';' -f1`
+       remaining=`echo $user_group_settings | cut -d ';' -f2-`
+       while test "x$setting" != "x"; do
+               cmd=`echo $setting | cut -d ' ' -f1`
+               opts=`echo $setting | cut -d ' ' -f2-`
+               # Different from useradd.bbclass, there's no file locking issue here, as
+               # this setting is actually a serial process. So we only retry once.
+               case $cmd in
+                       useradd)
+                               perform_useradd "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       groupadd)
+                               perform_groupadd "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       userdel)
+                               perform_userdel "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       groupdel)
+                               perform_groupdel "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       usermod)
+                               perform_usermod "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       groupmod)
+                               perform_groupmod "${IMAGE_ROOTFS}" "-R ${IMAGE_ROOTFS} $opts" 1
+                               ;;
+                       *)
+                               bbfatal "Invalid command in EXTRA_USERS_PARAMS: $cmd"
+                               ;;
+               esac
+               # iterate to the next setting
+               setting=`echo $remaining | cut -d ';' -f1`
+               remaining=`echo $remaining | cut -d ';' -f2-`
+       done
+}