User Commands                                         calendar(1)


NAME

     calendar - reminder service


SYNOPSIS

     calendar [-]


DESCRIPTION

     The calendar utility  consults  the  file  calendar  in  the
     current  directory  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  August  or
     24/8.   On  Fridays  and weekends "tomorrow" extends through
     Monday.  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  every  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 con-
     taining 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 conversion specifications.


EXAMPLES

     Example 1 Possible contents of a template

     The following example shows the possible contents of a  tem-
     plate:

       %B %eth of the year %Y

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

SunOS 5.11           Last change: 1 Feb 1995                    1


User Commands                                         calendar(1)

     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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWesu                     |
    |_____________________________|_____________________________|


SEE ALSO

     at(1),   crontab(1),    mail(1),    cron(1M),    ypbind(1M),
     strftime(3C), attributes(5), environ(5)


NOTES

     Appropriate lines beginning with white  space  will  not  be
     printed.

SunOS 5.11           Last change: 1 Feb 1995                    2


User Commands                                         calendar(1)

     Your calendar must be public information for you to get rem-
     inder service.

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

     The - argument works only on calendar files that  are  local
     to the machine; 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 direc-
     tories exist;  running  it  on  a  diskless  client  has  no
     effect.

     calendar is no longer in the default root  crontab.  Because
     of  the  network  burden  `calendar  -'  can  induce,  it is
     inadvisable in an  environment  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, indi-
     vidual users may wish to use `crontab -e' to edit their  own
     crontabs  to  have  cron invoke calendar without the - argu-
     ment, piping output to mail addressed to themselves.

SunOS 5.11           Last change: 1 Feb 1995                    3


Man(1) output converted with man2html


FhG Schily's Home VED powered