1 |
Hi, |
2 |
|
3 |
Here's v2 of my proposed format. Two changes: |
4 |
|
5 |
1. I've changed the 'header line' to start with '#!', so comment |
6 |
stripping normally takes care of it without having to do extra work. |
7 |
|
8 |
2. I've allowed Markdown syntax in note field, so that we can link |
9 |
commits similarly to how we do it on wiki. |
10 |
|
11 |
== UPDATED FORMAT == |
12 |
|
13 |
# vim:se ts=8 sts=8 tw=0 : |
14 |
# |
15 |
# This file provides a registry of active, requested and historical UID |
16 |
# and GID assignments in the Gentoo repository. Each line represents |
17 |
# a single record, with the '#!' line providing field headers. Empty |
18 |
# lines and comments are ignored. Fields are separated by whitespace, |
19 |
# with the last (note) field extending to end of line. Note that |
20 |
# additional fields may be added in the future. |
21 |
# |
22 |
# A single record can represent a user, a group or a combination of both |
23 |
# using the same name. Same user/group/UID/GID can be repeated |
24 |
# in mutiple records to reflect reality. If you can't express something |
25 |
# with a single record, split it. |
26 |
# |
27 |
# NAME: user/group name |
28 |
# UID: UID assigned to the user, or '-' if only group is defined |
29 |
# GID: GID assigned to the group, or '-' if only user is defined |
30 |
# PROVIDER: keyword identifying provider of user/group, see below |
31 |
# NOTES: human-readable notes about the assignment, optional, can use |
32 |
# Markdown syntax |
33 |
# |
34 |
# Valid values for PROVIDER are: |
35 |
# - acct: acct-user/${NAME} and/or acct-group/${NAME} packages |
36 |
# - baselayout: user/group defined in passwd/group files from baselayout |
37 |
# - baselayout-fbsd: same as baselayout but on FreeBSD system |
38 |
# - historical: historical UID/GID assignment, no longer used nowadays |
39 |
# - requested: assignment requested on the ml, not yet pushed |
40 |
# - reserved: special reserved range |
41 |
# - user.eclass: user/group created via user.eclass directly in package |
42 |
# |
43 |
# Use PROVIDERs that apply best at the moment. For example, if user |
44 |
# was migrated from user.eclass to acct-user/ with the same UID, just |
45 |
# list the latter. |
46 |
# |
47 |
# Please keep the list sorted by UID, GID, PROVIDER, NAME (in order). |
48 |
|
49 |
#!NAME UID GID PROVIDER NOTES |
50 |
root 0 0 baselayout |
51 |
root 0 - baselayout-fbsd |
52 |
toor 0 - baselayout-fbsd FreeBSD lists both names in passwd |
53 |
wheel - 0 baselayout-fbsd |
54 |
bin 1 1 baselayout |
55 |
daemon 1 1 baselayout-fbsd |
56 |
daemon 2 2 baselayout |
57 |
operator 2 5 baselayout-fbsd |
58 |
adm 3 4 baselayout |
59 |
bin 3 7 baselayout-fbsd |
60 |
sys - 3 baselayout |
61 |
sys - 3 baselayout-fbsd |
62 |
lp 4 7 baselayout |
63 |
tty 4 4 baselayout-fbsd |
64 |
sync 5 - baselayout |
65 |
kmem 5 2 baselayout-fbsd |
66 |
tty - 5 baselayout |
67 |
shutdown 6 - baselayout |
68 |
mail 6 6 baselayout-fbsd |
69 |
disk - 6 baselayout |
70 |
halt 7 - baselayout |
71 |
games 7 - baselayout-fbsd |
72 |
lp - 7 acct |
73 |
#... |
74 |
ftp 21 21 acct removed from baselayout svn in r1475 |
75 |
sshd 22 22 user.eclass removed from baselayout svn in r1476 |
76 |
at 25 25 user.eclass removed from baselayout svn in r1479 |
77 |
smtpd 25 25 user.eclass |
78 |
#... |
79 |
rpc 111 111 historical used by net-nds/portmap, removed in 36e60cce |
80 |
#... |
81 |
portage 250 250 baselayout |
82 |
#... |
83 |
(reserved) 500-999 500-999 reserved |
84 |
(reserved) 1000-60000 1000-60000 reserved UID_MIN-UID_MAX/GID_MIN-GID_MAX |
85 |
#... |
86 |
|
87 |
|
88 |
-- |
89 |
Best regards, |
90 |
Michał Górny |