|
|
1.1 ! root 1: .TH NFACCESS 8 "University of Illinois" ! 2: .SH NAME ! 3: nfaccess \- Add access rights to a set of Notesfiles ! 4: .SH SYNOPSIS ! 5: .B nfaccess ! 6: access-right ! 7: topic ! 8: [ topic ... ] ! 9: .SH DESCRIPTION ! 10: .B Nfaccess ! 11: simplifies the task of adding an access-right to many notesfiles. ! 12: The function is somewhat analagous to that of ! 13: .IR "chmod" "(1)." ! 14: .PP ! 15: The ! 16: .I "access-right" ! 17: specifies a user, group or system and the permissions to be ! 18: granted. ! 19: The format is: ! 20: ! 21: .in +1i ! 22: .nf ! 23: <access-right> ::= [<type>:]name=<mode> ! 24: <type> ::= {User, user, Group, group, System, system} ! 25: <mode> ::= {d, r, w, a, n}+ ! 26: .fi ! 27: .in ! 28: ! 29: The ! 30: .I type ! 31: specification can be omitted; ! 32: when it is omitted, the name is assumed to be a user. ! 33: The ! 34: .I mode ! 35: is additive. ! 36: A mode of ``rw'' specifies read and write. ! 37: The ``n'' mode specifies null access. ! 38: .PP ! 39: The new access right is inserted in each specified notesfiles ! 40: access list. ! 41: If the user/group/system already has an entry, the old entry ! 42: is replaced with the new entry. ! 43: .PP ! 44: All users are allowed to run this program. ! 45: The changes are only applied to notesfiles for which the executing ! 46: user is a director. ! 47: .PP ! 48: This program lives in the notesfile utility directory, ! 49: typically ``/usr/spool/notes/.utilities''. ! 50: .PP ! 51: To automatically add specific access-rights to newly created ! 52: notesfiles, the file ``/usr/spool/notes/.utilities/access-template'' ! 53: is useful. ! 54: If it exists, the file contains lines of acces-rights which ! 55: are added to each notesfile as it is created. ! 56: If several people share the administration of the notesfile ! 57: system, each can be added to the access-lists of newly ! 58: created notesfiles ! 59: by placing appropriate lines in this file. ! 60: .SH EXAMPLES ! 61: .in +1i ! 62: nfaccess essick=drw /usr/spool/notes/* ! 63: .br ! 64: nfaccess group:srg=rw this that other ! 65: .br ! 66: nfaccess user:kolstad=rw mynotes ! 67: .in ! 68: .PP ! 69: In the first example, user `essick' is given director/read/write ! 70: access to all the notesfiles in /usr/spool/notes. ! 71: Any permissions (or restrictions) he might have had before ! 72: are overridden. ! 73: The second example gives group `srg' read/write access to ! 74: notesfiles `this', `that' and `other'. ! 75: In the final example, user `kolstad' is given read/write access ! 76: to the notesfile `mynotes'. ! 77: .SH BUGS ! 78: Entries can not be removed from the access list with ! 79: this program. ! 80: .PP ! 81: Entries can not merely be augmented (``just add write permission'') ! 82: with this program. ! 83: .SH FILES ! 84: .PD 0 ! 85: .TP 35 ! 86: /etc/passwd ! 87: for the users name ! 88: .TP 35 ! 89: /etc/group ! 90: for the users group ! 91: .TP 35 ! 92: /usr/spool/notes ! 93: the default notesfile data base ! 94: .PD ! 95: .SH SEE ALSO ! 96: mknf(8), ! 97: notes(1), ! 98: nfcomment(3), ! 99: .br ! 100: .ul ! 101: The Notesfile Reference Manual ! 102: .SH AUTHORS ! 103: .nf ! 104: Ray Essick (uiucdcs!essick, essick%[email protected]) ! 105: University of Illinois at Urbana-Champaign ! 106: Urbana, IL ! 107: .fi
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.