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

FreeBSD Manual Pages

  
 
  

home | help
calendar(1)			 User Commands			   calendar(1)

NAME
       calendar	- reminder service

SYNOPSIS
       calendar	[-]

DESCRIPTION
       The  calendar  utility consults the file	calendar in the	current	direc-
       tory and	writes lines that contain today's or tomorrow's	date  anywhere
       in the line to standard output. Most reasonable month-day dates such as
       Aug. 24,	august 24, 8/24, and so	forth, are recognized, but not 24  Au-
       gust  or	 24/8. On Fridays and weekends "tomorrow" extends through Mon-
       day. calendar can be invoked regularly by using the crontab(1) or at(1)
       commands.

       When  the optional argument - is	present, calendar does its job for ev-
       ery user	who has	a file calendar	in his	or  her	 login	directory  and
       sends them any positive results by mail(1). Normally this is done daily
       by facilities in	the UNIX operating system (seecron(1M)).

       If the environment variable DATEMSK is set, calendar will use its value
       as the full path	name of	a template file	containing format strings. The
       strings consist of conversion specifications and	 text  characters  and
       are used	to provide a richer set	of allowable date formats in different
       languages by appropriate	settings of the	environment variable  LANG  or
       LC_TIME;	see environ(5).	Seestrftime(3C)	for the	list of	allowable con-
       version specifications.

EXAMPLES
       Example 1: Possible contents of a template

       The following example shows the possible	contents of a template:

       %B %eth of the year %Y

       %B represents the full month name, %e the day of	month and %Y the  year
       (4 digits).

       If  DATEMSK  is set to this template, the following calendar file would
       be valid:

       March 7th of the	year 1989 <Reminder>

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following	environment  variables
       that  affect the	execution of calendar: LC_CTYPE, LC_TIME, LC_MESSAGES,
       NLSPATH,	and TZ.

EXIT STATUS
       0	Successful completion.

       >0	An error occurred.

FILES
       /etc/passwd	       system password file

       /tmp/cal*	       temporary files used by calendar

       /usr/lib/calprog	       program used to determine dates for  today  and
			       tomorrow

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWesu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       at(1),  crontab(1),  mail(1),  cron(1M),	 ypbind(1M), strftime(3C), at-
       tributes(5), environ(5)

NOTES
       Appropriate lines beginning with	white space will not be	printed.

       Your calendar must be public information	for you	to get	reminder  ser-
       vice.

       calendar's extended idea	of ``tomorrow''	does not account for holidays.

       The  -  argument	works only on calendar files that are local to the ma-
       chine; calendar is intended not to work	on  calendar  files  that  are
       mounted	remotely  with	NFS.  Thus, `calendar -' should	be run only on
       diskful machines	where home directories exist;  running it on  a	 disk-
       less client has no effect.

       calendar	 is no longer in the default root crontab. Because of the net-
       work burden `calendar -'	can induce, it is inadvisable in  an  environ-
       ment  running  ypbind(1M) with a	large passwd.byname map.  If, however,
       the usefulness of calendar outweighs the	network	impact,	the super-user
       may  run	 `crontab  -e' to edit the root	crontab. Otherwise, individual
       users may wish to use `crontab -e' to edit their	own crontabs  to  have
       cron  invoke calendar without the - argument, piping output to mail ad-
       dressed to themselves.

SunOS 5.10			  1 Feb	1995			   calendar(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | ENVIRONMENT VARIABLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=calendar&sektion=1&manpath=SunOS+5.10>

home | help