| 1 |
commit: 19a7ba32b83fc16f51f907358a978fe6ace4bedb |
| 2 |
Author: Michał Górny <mgorny <AT> gentoo <DOT> org> |
| 3 |
AuthorDate: Fri Dec 20 16:47:23 2019 +0000 |
| 4 |
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Thu Dec 26 22:01:53 2019 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=19a7ba32 |
| 7 |
|
| 8 |
ebuild-writing/users-and-groups: Update policy |
| 9 |
|
| 10 |
Closes: https://github.com/gentoo/devmanual/pull/125 |
| 11 |
Signed-off-by: Michał Górny <mgorny <AT> gentoo.org> |
| 12 |
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org> |
| 13 |
|
| 14 |
ebuild-writing/users-and-groups/text.xml | 29 +++++++++++++++++------------ |
| 15 |
1 file changed, 17 insertions(+), 12 deletions(-) |
| 16 |
|
| 17 |
diff --git a/ebuild-writing/users-and-groups/text.xml b/ebuild-writing/users-and-groups/text.xml |
| 18 |
index 26d23ab..1bb87b3 100644 |
| 19 |
--- a/ebuild-writing/users-and-groups/text.xml |
| 20 |
+++ b/ebuild-writing/users-and-groups/text.xml |
| 21 |
@@ -6,21 +6,26 @@ |
| 22 |
<body> |
| 23 |
<p> |
| 24 |
Creating users and groups is governed by <uri |
| 25 |
-link="https://gentoo.org/glep/glep-0081.html">GLEP 81</uri>. It is implemented |
| 26 |
-via <c>acct-user</c> and <c>acct-group</c> eclasses. |
| 27 |
+link="https://gentoo.org/glep/glep-0081.html">GLEP 81</uri>. It is implemented |
| 28 |
+via <c>acct-user</c> and <c>acct-group</c> eclasses. New users and groups |
| 29 |
+are created as packages respectively in <c>acct-user</c> and <c>acct-group</c> |
| 30 |
+categories. |
| 31 |
</p> |
| 32 |
|
| 33 |
<p> |
| 34 |
-New users and groups are created as packages respectively in <c>acct-user</c> |
| 35 |
-and <c>acct-group</c> categories. First, choose UIDs/GIDs that are not used by |
| 36 |
-any other package. You should consult the <uri |
| 37 |
-link="https://wiki.gentoo.org/wiki/Project:Quality_Assurance/UID_GID_Assignment"> |
| 38 |
-UID/GID assignment list</uri> maintained by the QA project, and possibly the |
| 39 |
-UID/GID registries maintained by other distributions that are linked on the |
| 40 |
-same page. Afterwards, send the proposed ebuilds to the <c>gentoo-dev</c> |
| 41 |
-mailing list for review. The naming conventions for user and group ebuilds are |
| 42 |
-explained in the following sections. Finally, after getting positive reviews, |
| 43 |
-commit the new user and group packages. |
| 44 |
+First, check the <uri link="https://api.gentoo.org/uid-gid.txt">UID/GID |
| 45 |
+assignment list</uri> and choose a free UID/GID in range 101..499. If you are |
| 46 |
+adding a matching user and group, use the same number for both. When in doubt, |
| 47 |
+take the next free number from 499 downwards. |
| 48 |
+</p> |
| 49 |
+ |
| 50 |
+<p> |
| 51 |
+The aforementioned list can be found in the |
| 52 |
+<uri link="https://gitweb.gentoo.org/data/api.git">data/api.git</uri> repository |
| 53 |
+on <c>git.gentoo.org</c>. Add your new user(s) and group(s) |
| 54 |
+to the <c>uid-gid.txt</c> file and push them before adding the actual packages. |
| 55 |
+This counts as reserving the identifiers and will prevent collisions. |
| 56 |
+Afterwards, you can push the new ebuilds. |
| 57 |
</p> |
| 58 |
|
| 59 |
<p> |
Archives