bsd man page for nfaccess

NFACCESS(8)						      System Manager's Manual						       NFACCESS(8)

NAME
       nfaccess - Add access rights to a set of Notesfiles

SYNOPSIS
       nfaccess access-right topic [ topic ... ]

DESCRIPTION
       Nfaccess simplifies the task of adding an access-right to many notesfiles.  The function is somewhat analagous to that of chmod(1).

       The access-right specifies a user, group or system and the permissions to be granted.  The format is:

		 <access-right> ::= [<type>:]name=<mode>
		 <type>    ::= {User, user, Group, group, System, system}
		 <mode>    ::= {d, r, w, a, n}+

       The type specification can be omitted; when it is omitted, the name is assumed to be a user.  The mode is additive.  A mode of ``rw'' spec-
       ifies read and write.  The ``n'' mode specifies null access.

       The new access right is inserted in each specified notesfiles access list.  If the user/group/system already has an entry, the old entry is
       replaced with the new entry.

       All users are allowed to run this program.  The changes are only applied to notesfiles for which the executing user is a director.

       This program lives in the notesfile utility directory, typically ``/usr/spool/notes/.utilities''.

       To  automatically  add specific access-rights to newly created notesfiles, the file ``/usr/spool/notes/.utilities/access-template'' is use-
       ful.  If it exists, the file contains lines of acces-rights which are added to each notesfile as it is created.	If  several  people  share
       the  administration of the notesfile system, each can be added to the access-lists of newly created notesfiles by placing appropriate lines
       in this file.

EXAMPLES
		 nfaccess essick=drw /usr/spool/notes/*
		 nfaccess group:srg=rw this that other
		 nfaccess user:kolstad=rw mynotes

       In the first example, user `essick' is given director/read/write access to all the notesfiles in  /usr/spool/notes.   Any  permissions  (or
       restrictions) he might have had before are overridden.  The second example gives group `srg' read/write access to notesfiles `this', `that'
       and `other'.  In the final example, user `kolstad' is given read/write access to the notesfile `mynotes'.

BUGS
       Entries can not be removed from the access list with this program.

       Entries can not merely be augmented (``just add write permission'') with this program.

FILES
       /etc/passwd			  for the users name
       /etc/group			  for the users group
       /usr/spool/notes 		  the default notesfile data base

SEE ALSO
       mknf(8), notes(1), nfcomment(3),
       The Notesfile Reference Manual

AUTHORS
       Ray Essick (uiucdcs!essick, essick%uiuc@csnet-relay.arpa)
       University of Illinois at Urbana-Champaign
       Urbana, IL

							      University of Illinois						       NFACCESS(8)