'\" te
.\"  Copyright 1989 AT&T Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\"  Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation.Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
.\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material.
.TH calendar 1 "1995 年 2 月 1 日" "SunOS 5.11" "ユーザーコマンド"
.SH 名前
カレンダ \- リマインダサービス
.SH 形式
.LP
.nf
\fBcalendar\fR [\fB-\fR]
.fi

.SH 機能説明
.sp
.LP
\fBcalendar\fR ユーティリティーは、現在のディレクトリ内の \fBcalendar\fR ファイルを参照し、行内の任意の位置に今日または明日の日付を含む行を標準出力に書き込みます。\fBAug. 24\fR、\fBaugust 24\fR、\fB8/24\fR などのもっとも一般的な月と日の日付は認識されますが、\fB24 August\fR や \fB24/8\fR は認識されません。金曜日と週末には、「明日」は月曜日まで拡張されます。\fBcalendar\fR は、\fBcrontab\fR(1) または \fBat\fR(1) コマンドを使用して定期的に呼び出すことができます。
.sp
.LP
オプションの引数 \fB-\fR が存在する場合、\fBcalendar\fR は、自分のログインディレクトリ内に \fBcalendar\fR ファイルを持っているすべてのユーザーに対して処理を実行し、すべての正の結果を \fBmail\fR(1) でそれらのユーザーに送信します。通常、これは、UNIX オペレーティングシステム内の機能によって毎日実行されます (\fBcron\fR(1M) を参照)。
.sp
.LP
環境変数 \fBDATEMSK\fR が設定されている場合、\fBcalendar\fR は、その値を書式文字列を含むテンプレートファイルのフルパス名として使用します。これらの文字列は変換仕様とテキスト文字で構成されており、環境変数 \fBLANG\fR または \fBLC_TIME\fR の適切な設定によって、異なる言語で許容されるより豊富な一連の日付の形式を提供するために使用されます。\fBenviron\fR(5) を参照してください。許容可能な変換仕様のリストについては、\fBstrftime\fR(3C) を参照してください。
.SH 使用例
.LP
\fB例 1 \fRテンプレートの内容の例
.sp
.LP
次の例は、テンプレートの内容の例を示しています。

.sp
.in +2
.nf
%B %eth of the year %Y
.fi
.in -2
.sp

.sp
.LP
\fB%B\fR は完全な月の名前、\fB%e\fR は日付、\fB%Y\fR は年 (4 桁) をそれぞれ表しています。

.sp
.LP
\fBDATEMSK\fR がこのテンプレートに設定されている場合は、次の \fBcalendar\fR ファイルが有効になります。

.sp
.in +2
.nf
March 7th of the year 1989 <Reminder>
.fi
.in -2
.sp

.SH 環境
.sp
.LP
\fBcalendar\fR の実行に影響を与える次の環境変数についての詳細は、\fBenviron\fR(5) を参照してください。\fBLC_CTYPE\fR、\fBLC_TIME\fR、\fBLC_MESSAGES\fR、\fBNLSPATH\fR、および \fBTZ\fR。  
.SH 終了ステータス
.sp
.ne 2
.mk
.na
\fB\fB0\fR \fR
.ad
.RS 7n
.rt  
正常終了。
.RE

.sp
.ne 2
.mk
.na
\fB\fB>0\fR \fR
.ad
.RS 7n
.rt  
エラーが発生した。
.RE

.SH ファイル
.sp
.ne 2
.mk
.na
\fB\fB/etc/passwd\fR \fR
.ad
.RS 21n
.rt  
システムパスワードファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/tmp/cal*\fR \fR
.ad
.RS 21n
.rt  
\fBcalendar\fR で使用される一時ファイル
.RE

.sp
.ne 2
.mk
.na
\fB\fB/usr/lib/calprog\fR \fR
.ad
.RS 21n
.rt  
今日と明日の日付を判定するために使用されるプログラム
.RE

.SH 属性
.sp
.LP
属性についての詳細は、マニュアルページの \fBattributes\fR(5) を参照してください。
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
属性タイプ属性値
_
使用条件system/core-os
.TE

.SH 関連項目
.sp
.LP
\fBat\fR(1), \fBcrontab\fR(1), \fBmail\fR(1), \fBcron\fR(1M), \fBypbind\fR(1M), \fBstrftime\fR(3C), \fBattributes\fR(5), \fBenviron\fR(5)
.SH 注意事項
.sp
.LP
スペースで始まる該当する行は出力されません。
.sp
.LP
リマインダサービスを受けるには、使用するカレンダがパブリック情報である必要があります。
.sp
.LP
\fBcalendar\fR の「明日」という拡張された考え方は、祭日には適用されません。
.sp
.LP
\fB-\fR 引数は、マシンに対してローカルなカレンダファイルでのみ機能します。\fBcalendar\fR は、\fBNFS.\fR によってリモートでマウントされたカレンダファイルで機能するようには考慮されていません。そのため、「\fBcalendar \fR\fB-\fR」は、ホームディレクトリが存在するディスクフルマシン上でのみ実行するようにしてください。ディスクレスクライアント上で実行しても効果はありません。
.sp
.LP
\fBcalendar\fR は、デフォルトの root の crontab には存在しなくなりました。「\fBcalendar \fR\fB-\fR」はネットワーク負荷を発生させる場合があるため、大きな passwd.byname マップが含まれた \fBypbind\fR(1M) を実行している環境で使用することはお勧めできません。ただし、\fBcalendar\fR の有用性がネットワークへの影響より重要である場合は、スーパーユーザーが「\fBcrontab\fR \fB-e\fR」を実行して root の crontab を編集できます。それ以外の場合は、個々のユーザーが「\fBcrontab\fR \fB-e\fR」を使用して、\fBcron\fR が \fB-\fR 引数なしで \fBcalendar\fR を呼び出し、出力をパイプ経由で自分宛てのメールに渡すように独自の crontab を編集することもできます。