Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PACKAGE(1)		    General Commands Manual		    PACKAGE(1)

NAME
       package - register package user via mailagent

SYNOPSIS
       package address system version patchlevel [ mailpatches | notifypatches
       ]

DESCRIPTION
       This command is not intended to be run directly by a user, but may  ap-
       pear  in	 any  mail  whose subject is set to Command. Such mail will be
       processed by the	mailagent(1), which will extract all  lines  beginning
       with  @SH, which	may specify this command. The mailagent	first sets en-
       vironment variables that	will be	used by	the command.

       Package is used to notify the author of a package about its users.   It
       is  normally  generated automatically by	the MailAuthor.U unit when the
       user runs Configure.

       If the patchlevel specified is not the latest for that system and  ver-
       sion,  mail  is	immediately  sent suggesting that they upgrade and re-
       mindng them how to request the latest patches.

       The final parameter, if included	may be set to mailpatches  to  specify
       that  the user would like to have future	patches	mailed to them,	or no-
       tifypatches to specify that  a  mail  notification  of  future  patches
       should be sent, rather than the entire patch.

       The user's address and notification request are saved in	the file users
       in the package's	directory.

       Package performs	an approximate address match in	order to avoid	dupli-
       cate  entries.	Whenever this elimination occurs, a warning message is
       issued in the logfile.  Two addresses will be said equivalent if	one of
       them  has an added machine name or if they are really equal. Therefore,
       the following addresses are equivalent:

	    ram@acri.fr
	    ram@main.acri.fr

       whereas the following two are not equivalent, unfortunately:

	    ram@acri.acri.fr
	    ram@main.acri.fr

       When a user is asking to	be left	alone, it is important to let him know
       if  the request failed, because he will be annoyed when the next	set of
       patches is issued and he	still gets them	despite	his previous  request.
       Therefore,  if  no  approximate match occurs, a warning message is sent
       back, with a list of addresses that are close to	 his  own  e-mail  ad-
       dress,  but  not	 equivalent.  Fortunately, the following addresses are
       considered close:

	    ram@acri.fr
	    ram@somewhere.com
	    raphael@main.acri.fr
	    manfredi@acri.acri.fr

       because they either have	the same login (important when someone changes
       company)	or share the same domain or sub-domain part.

       In order	to edit	the users file,	the edusers script should be used. For
       one thing, it will let you edit the users file  from  whatever  package
       you  name  in the command line, but it will also	properly lock the file
       so that the execution of	package	will stall for	the  duration  of  the
       manual  edition	(provided  you have a strict locking policy defined in
       your ~/.mailagent configuration file).

FORWARDING
       Package supports	command	forwarding as  described  in  the  mailhelp(1)
       page.

FILES
       ~/.mailagent	   configuration file for mailagent.
       System/users	   list	of users of that system.
			   This	 file consists of single line records, one for
			   each	registered  user.   Each  record  consists  of
			   three tab-separated fields.

			   The	first field indicates the level	of updates re-
			   quested by the user by a single letter as follows:
			   M	  Mail future patches  directly	 to  the  user
				  when they are	issued.
			   N	  Notify the user of future patches.
			   U	  The  users chose to let the author know that
				  they have tried the program,	but  does  not
				  wish to know about future updates.
			   L	  The user is no longer	interested in the pro-
				  gram and wants to be left alone.

			   The second  field  is  their	 last  notified	 patch
			   level, or a dash (-)	if it is not known.

			   The third field is the user's Email address.
       Log/agentlog	   mailagent's log file

AUTHORS
       Graham Stoney <greyham@research.canon.oz.au>
       Raphael Manfredi	<Raphael_Manfredi@pobox.com> (minor enhancements)

SEE ALSO
       edusers(1), mailagent(1), metaconfig(1).

								    PACKAGE(1)

NAME | SYNOPSIS | DESCRIPTION | FORWARDING | FILES | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=package&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help