Add user/group management docs to werc site.
This commit is contained in:
parent
12c48bb7e7
commit
26c9a8b2b7
31
sites/werc.cat-v.org/docs/user_management.md
Normal file
31
sites/werc.cat-v.org/docs/user_management.md
Normal file
@ -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 ...]
|
Loading…
Reference in New Issue
Block a user