👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

Linux 2.6 - man page for cal (linux section 1posix)

CAL(P)				    POSIX Programmer's Manual				   CAL(P)

NAME
       cal - print a calendar

SYNOPSIS
       cal [[month] year ]

DESCRIPTION
       The  cal  utility  shall write a calendar to standard output using the Julian calendar for
       dates from January 1, 1 through September 2, 1752 and the  Gregorian  calendar  for  dates
       from  September	14,  1752  through December 31, 9999 as though the Gregorian calendar had
       been adopted on September 14, 1752.

OPTIONS
       None.

OPERANDS
       The following operands shall be supported:

       month  Specify the month to be displayed, represented as a decimal integer from	1  (Janu-
	      ary) to 12 (December). The default shall be the current month.

       year   Specify  the  year  for  which  the calendar is displayed, represented as a decimal
	      integer from 1 to 9999. The default shall be the current year.

STDIN
       Not used.

INPUT FILES
       None.

ENVIRONMENT VARIABLES
       The following environment variables shall affect the execution of cal:

       LANG   Provide a default value for the internationalization variables that  are	unset  or
	      null. (See the Base Definitions volume of IEEE Std 1003.1-2001, Section 8.2, Inter-
	      nationalization Variables for the precedence of internationalization variables used
	      to determine the values of locale categories.)

       LC_ALL If  set  to a non-empty string value, override the values of all the other interna-
	      tionalization variables.

       LC_CTYPE
	      Determine the locale for the interpretation of sequences of bytes of text  data  as
	      characters  (for	example, single-byte as opposed to multi-byte characters in argu-
	      ments).

       LC_MESSAGES
	      Determine the locale that should be used to affect the format and contents of diag-
	      nostic  messages	written  to  standard  error, and informative messages written to
	      standard output.

       LC_TIME
	      Determine the format and contents of the calendar.

       NLSPATH
	      Determine the location of message catalogs for the processing of LC_MESSAGES .

       TZ     Determine the timezone used to calculate the value of the current month.

ASYNCHRONOUS EVENTS
       Default.

STDOUT
       The standard output shall be used to display the calendar, in an unspecified format.

STDERR
       The standard error shall be used only for diagnostic messages.

OUTPUT FILES
       None.

EXTENDED DESCRIPTION
       None.

EXIT STATUS
       The following exit values shall be returned:

	0     Successful completion.

       >0     An error occurred.

CONSEQUENCES OF ERRORS
       Default.

       The following sections are informative.

APPLICATION USAGE
       Note that:

	      cal 83

       refers to A.D. 83, not 1983.

EXAMPLES
       None.

RATIONALE
       None.

FUTURE DIRECTIONS
       A future version of IEEE Std 1003.1-2001 may support locale-specific  recognition  of  the
       date of adoption of the Gregorian calendar.

SEE ALSO
       None.

COPYRIGHT
       Portions  of  this  text  are  reprinted  and  reproduced in electronic form from IEEE Std
       1003.1, 2003 Edition, Standard for Information Technology  --  Portable	Operating  System
       Interface  (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003 by
       the Institute of Electrical and Electronics Engineers, Inc and  The  Open  Group.  In  the
       event  of  any  discrepancy  between this version and the original IEEE and The Open Group
       Standard, the original IEEE and The Open Group Standard is the referee document. The orig-
       inal Standard can be obtained online at http://www.opengroup.org/unix/online.html .

IEEE/The Open Group			       2003					   CAL(P)


All times are GMT -4. The time now is 06:43 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password