commit ad119279b4b38bf5cc77ce38c5c63ce2bc830b10 parent 06b6d470ed4bc362280a3b8f6c5baac762c7fa2d Author: uriel@soma <unknown> Date: Fri, 13 Feb 2009 00:57:31 +0000 Add user/group management docs to werc site. Diffstat:
A | sites/werc.cat-v.org/docs/user_management.md | | | 31 | +++++++++++++++++++++++++++++++ |
1 file changed, 31 insertions(+), 0 deletions(-)
diff --git a/sites/werc.cat-v.org/docs/user_management.md b/sites/werc.cat-v.org/docs/user_management.md @@ -0,0 +1,31 @@ +User and Group Management +========================= + +User accounts and group membership are stored under `etc/users/` and `etc/groups/` respectively. + +A user account consists of a directory under `etc/users/` that contains files with that users account information, the only required file is `password` containing a password for the user. For example: + + % ls etc/users/ + eekee uriel yosyp + % cat etc/users/uriel/password + mypass + +Groups consists of files named after the group name stored in `etc/groups/`, containing the names of the group members, one per line. + +The group 'admin' is 'built-in' and any members in that group will have admin privileges for most werc apps by default. + +Example +------- + +To create a user called [glenda](http://glenda.cat-v.org) that is a member of the group `rabbits` you can do: + + % mkdir etc/users/glenda/ + % echo passw > etc/user/glenda/password + % echo glenda >> etc/users/rabbits + +Utils +----- + +The script at bin/aux/addwuser.rc allows you to even more trivially add users. + + addwuser.rc user_name user_pass [groups ...]