diff options
Diffstat (limited to 'documentation/ref-manual/ref-classes.xml')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index 7124c49560..9752767c69 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml | |||
@@ -535,6 +535,44 @@ | |||
535 | </para> | 535 | </para> |
536 | </section> | 536 | </section> |
537 | 537 | ||
538 | <section id='ref-classes-extrausers'> | ||
539 | <title><filename>extrausers.bbclass</filename></title> | ||
540 | |||
541 | <para> | ||
542 | The extra users (<filename>extrausers</filename>) class allows | ||
543 | additional user and group configuration to be applied at the image | ||
544 | level. | ||
545 | Inheriting this class either globally or from an image recipe allows | ||
546 | additional user and group operations to be performed using the | ||
547 | <link linkend='var-EXTRA_USERS_PARAMS'><filename>EXTRA_USERS_PARAMS</filename></link> | ||
548 | variable. | ||
549 | <note> | ||
550 | The user and group operations added using the | ||
551 | <filename>extrausers</filename> class are not tied to a specific | ||
552 | recipe but can be performed across the image as a whole. | ||
553 | See the | ||
554 | <link linkend='ref-classes-useradd'><filename>useradd</filename></link> | ||
555 | class for information on how to add user and group configuration | ||
556 | to a specific recipe. | ||
557 | </note> | ||
558 | </para> | ||
559 | |||
560 | <para> | ||
561 | Here is an example that uses this class in an image recipe: | ||
562 | <literallayout class='monospaced'> | ||
563 | inherit extrausers | ||
564 | EXTRA_USERS_PARAMS = "\ | ||
565 | useradd -p '' tester; \ | ||
566 | groupadd developers; \ | ||
567 | userdel nobody; \ | ||
568 | groupdel -g video; \ | ||
569 | groupmod -g 1020 developers; \ | ||
570 | usermod -s /bin/sh tester; \ | ||
571 | " | ||
572 | </literallayout> | ||
573 | </para> | ||
574 | </section> | ||
575 | |||
538 | <section id='ref-classes-debian'> | 576 | <section id='ref-classes-debian'> |
539 | <title>Debian Renaming - <filename>debian.bbclass</filename></title> | 577 | <title>Debian Renaming - <filename>debian.bbclass</filename></title> |
540 | 578 | ||