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>

1 files changed, 61 insertions, 0 deletions

diff --git a/meta/classes/extrausers.bbclass b/meta/classes/extrausers.bbclass
new file mode 100644
index 0000000000..8670a2a85a
--- /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
+}