Return to nfaccess.8 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / notes / man

Annotation of 43BSDTahoe/new/notes/man/nfaccess.8, revision 1.1.1.1

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.