calendar

 

---

 
 
 
 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 cron-
      tab(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).
 
      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.
 
 
 
 
 
 SunOS 5.8            Last change: 1 Feb 1995                    1
 
 
 
 
 
 
 User Commands                                         calendar(1)
 
 
 
 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.
 
      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
 
 
 
 SunOS 5.8            Last change: 1 Feb 1995                    2
 
 
 
 
 
 
 User Commands                                         calendar(1)
 
 
 
      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.8            Last change: 1 Feb 1995                    3
 
 
 

---