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

FreeBSD Manual Pages

  
 
  

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

NAME
     uscheduleconf - configure a scheduling service

SYNOPSIS
     uscheduleconf DIR ACCT LOGACCT [JOBDIR [LOGDIR]]

DESCRIPTION
     uscheduleconf  creates  a svscan service directory DIR, which starts a ser-
     vice to uschedule for the user ACCT. The jobs will be read from JOBDIR  (or
     ~ACCT/.uschedule,	if  JOBDIR is not given or only contains a minus charac-
     ter).

     Logging information will be written to LOGDIR (or ~ACCT/.uschedule/log,  if
     LOGDIR is not given), using the the account LOGACCT.

     Version  before  0.7.0 allowed to give "-" for ACCT to use the current user
     and "-" for LOGACCT to use ACCT for LOGACCT, but the code turned out to  be
     buggy. See the NEWS file of the uschedule package for more information.

OPTIONS
     -n, --no-user-change
	    Do not change file ownership and do not switch user ids.

	    The default is to make ACCT and LOGACCT the owners of JOBDIR, LOGDIR
	    and  the file therein, and to switch to ACCT and LOGACCT before run-
	    ning uscheduled and the logging program.

	    With this option the caller will be the owner of all  files  created
	    and the programs will run with all the rights they inherit.

	    This option was added in version 0.7.0.

ENVIRONMENT
     In JOBDIR/env a number of environment variables are set (one file per vari-
     able).  HOME, SHELL, USER and LOGNAME are set to values taken from the sys-
     tem password database.
     The PATH variable is set to /command:/usr/local/bin:/usr/bin/:/bin for  any
     user   not   having   an	uid   of  0.  For  users  with	uid  0	/usr/lo-
     cal/sbin:/usr/sbin:/sbin will be appended.

     All these variables may be changed.

SECURITY
     Keep the following rules in mind:

     *

	 Do not ever create a service directory DIR in an insecure  place.   No-
	body  but  you - the system administrator - must be able to write to it.
	Especially do not ever create this directory in  the  users  $HOME.  You
	would be giving away instant root access!

     *

	  Do  not ever create JOBDIR and LOGDIR in an insecure place.  These di-
	rectories and the content must only be writable by the	user  for  which
	the service is run.

     *

	 Be careful about LOGACCT. If you set up a scheduling service for a user
	then  LOGACCT  should  be  this user. If you are setting up a scheduling
	service for a system account then you may want to use a  different  user
	for  logging  purposes	(while this is local policy i can't think of any
	reason why the logging should run as root).

     *

	 Resource limits may be configured in DIR/run and DIR/log/run.	The  de-
	faults	are  most possibly not right for every system. Keep in mind that
	perl eats lots of resources and that a multilog processor may  use  perl
	...

EXAMPLES
   Setup a scheduler for system services
     Create  a uschedule service for root, with the service directory /etc/root-
     schedule and the logging done to /var/log/root-schedule under the "misclog"
     account.

	 uscheduleconf /etc/root-schedule root misclog \
		  /etc/root-schedule/jobs /var/log/root-schedule

   Setup a scheduler for a user
     Create a schedule service for uwe, having the trusted commands in /etc/uwe-
     schedule and any parts uwe can change in ~uwe/.uschedule:

	 uscheduleconf /etc/uwe-schedule uwe uwe \
		  ~uwe/.uschedule ~uwe/.uschedule/logs

AUTHOR
     Uwe Ohse, uwe@ohse.de

SEE ALSO
     uschedule(1), uschedulecmd(1), uschedule_intro(7).

     The homepage may be more up-to-date, see
     http://www.ohse.de/uwe/uschedule.html.

uschedule			      0.7.1			uscheduleconf(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=uscheduleconf&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help