aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2019-12-20 17:47:23 +0100
committerGöktürk Yüksek <gokturk@gentoo.org>2019-12-26 17:01:53 -0500
commit19a7ba32b83fc16f51f907358a978fe6ace4bedb (patch)
tree8219b95c72b1f901d13c23388ba113851c3ea42e /ebuild-writing
parenttasks-reference/pam: remove needless pam section (diff)
downloaddevmanual-19a7ba32b83fc16f51f907358a978fe6ace4bedb.tar.gz
devmanual-19a7ba32b83fc16f51f907358a978fe6ace4bedb.tar.bz2
devmanual-19a7ba32b83fc16f51f907358a978fe6ace4bedb.zip
ebuild-writing/users-and-groups: Update policy
Closes: https://github.com/gentoo/devmanual/pull/125 Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/users-and-groups/text.xml29
1 files changed, 17 insertions, 12 deletions
diff --git a/ebuild-writing/users-and-groups/text.xml b/ebuild-writing/users-and-groups/text.xml
index 26d23ab..1bb87b3 100644
--- a/ebuild-writing/users-and-groups/text.xml
+++ b/ebuild-writing/users-and-groups/text.xml
@@ -6,21 +6,26 @@
<body>
<p>
Creating users and groups is governed by <uri
-link="https://gentoo.org/glep/glep-0081.html">GLEP 81</uri>. It is implemented
-via <c>acct-user</c> and <c>acct-group</c> eclasses.
+link="https://gentoo.org/glep/glep-0081.html">GLEP 81</uri>. It is implemented
+via <c>acct-user</c> and <c>acct-group</c> eclasses. New users and groups
+are created as packages respectively in <c>acct-user</c> and <c>acct-group</c>
+categories.
</p>
<p>
-New users and groups are created as packages respectively in <c>acct-user</c>
-and <c>acct-group</c> categories. First, choose UIDs/GIDs that are not used by
-any other package. You should consult the <uri
-link="https://wiki.gentoo.org/wiki/Project:Quality_Assurance/UID_GID_Assignment">
-UID/GID assignment list</uri> maintained by the QA project, and possibly the
-UID/GID registries maintained by other distributions that are linked on the
-same page. Afterwards, send the proposed ebuilds to the <c>gentoo-dev</c>
-mailing list for review. The naming conventions for user and group ebuilds are
-explained in the following sections. Finally, after getting positive reviews,
-commit the new user and group packages.
+First, check the <uri link="https://api.gentoo.org/uid-gid.txt">UID/GID
+assignment list</uri> and choose a free UID/GID in range 101..499. If you are
+adding a matching user and group, use the same number for both. When in doubt,
+take the next free number from 499 downwards.
+</p>
+
+<p>
+The aforementioned list can be found in the
+<uri link="https://gitweb.gentoo.org/data/api.git">data/api.git</uri> repository
+on <c>git.gentoo.org</c>. Add your new user(s) and group(s)
+to the <c>uid-gid.txt</c> file and push them before adding the actual packages.
+This counts as reserving the identifiers and will prevent collisions.
+Afterwards, you can push the new ebuilds.
</p>
<p>