# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-05-01 04:39+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: build/C/man3/adjtime.3:23
#, no-wrap
msgid "ADJTIME"
msgstr ""

#. type: TH
#: build/C/man3/adjtime.3:23
#, no-wrap
msgid "2008-06-22"
msgstr ""

#. type: TH
#: build/C/man3/adjtime.3:23 build/C/man2/adjtimex.2:29 build/C/man3/clock_getcpuclockid.3:24 build/C/man2/clock_nanosleep.2:24 build/C/man3/futimes.3:25 build/C/man2/gettimeofday.2:40 build/C/man2/nanosleep.2:35 build/C/man4/rtc.4:29 build/C/man2/stime.2:30 build/C/man2/time.2:29 build/C/man7/time.7:26 build/C/man3/timeradd.3:25 build/C/man2/times.2:38 build/C/man2/utime.2:31 build/C/man2/utimensat.2:26
#, no-wrap
msgid "Linux"
msgstr ""

#. type: TH
#: build/C/man3/adjtime.3:23 build/C/man2/adjtimex.2:29 build/C/man3/clock.3:27 build/C/man3/clock_getcpuclockid.3:24 build/C/man2/clock_getres.2:32 build/C/man2/clock_nanosleep.2:24 build/C/man3/ctime.3:33 build/C/man3/difftime.3:28 build/C/man3/dysize.3:24 build/C/man3/ftime.3:31 build/C/man3/futimes.3:25 build/C/man3/getdate.3:28 build/C/man2/gettimeofday.2:40 build/C/man2/nanosleep.2:35 build/C/man4/rtc.4:29 build/C/man2/stime.2:30 build/C/man3/strftime.3:35 build/C/man3/strptime.3:29 build/C/man2/time.2:29 build/C/man7/time.7:26 build/C/man3/timegm.3:23 build/C/man3/timeradd.3:25 build/C/man2/times.2:38 build/C/man5/tzfile.5:4 build/C/man3/tzset.3:31 build/C/man2/utime.2:31 build/C/man2/utimensat.2:26
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:24 build/C/man2/adjtimex.2:30 build/C/man3/clock.3:28 build/C/man3/clock_getcpuclockid.3:25 build/C/man2/clock_getres.2:33 build/C/man2/clock_nanosleep.2:25 build/C/man3/ctime.3:34 build/C/man3/difftime.3:29 build/C/man3/dysize.3:25 build/C/man3/ftime.3:32 build/C/man3/futimes.3:26 build/C/man3/getdate.3:29 build/C/man2/gettimeofday.2:41 build/C/man2/nanosleep.2:36 build/C/man4/rtc.4:30 build/C/man2/stime.2:31 build/C/man3/strftime.3:36 build/C/man3/strptime.3:30 build/C/man1/time.1:8 build/C/man2/time.2:30 build/C/man7/time.7:27 build/C/man3/timegm.3:24 build/C/man3/timeradd.3:26 build/C/man2/times.2:39 build/C/man5/tzfile.5:5 build/C/man8/tzselect.8:4 build/C/man3/tzset.3:32 build/C/man2/utime.2:32 build/C/man2/utimensat.2:27 build/C/man8/zdump.8:4 build/C/man8/zic.8:4
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:26
msgid "adjtime - correct the time to synchronize the system clock"
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:26 build/C/man2/adjtimex.2:32 build/C/man3/clock.3:30 build/C/man3/clock_getcpuclockid.3:27 build/C/man2/clock_getres.2:35 build/C/man2/clock_nanosleep.2:27 build/C/man3/ctime.3:37 build/C/man3/difftime.3:31 build/C/man3/dysize.3:27 build/C/man3/ftime.3:34 build/C/man3/futimes.3:28 build/C/man3/getdate.3:31 build/C/man2/gettimeofday.2:43 build/C/man2/nanosleep.2:38 build/C/man4/rtc.4:32 build/C/man2/stime.2:33 build/C/man3/strftime.3:38 build/C/man3/strptime.3:32 build/C/man1/time.1:10 build/C/man2/time.2:32 build/C/man3/timegm.3:26 build/C/man3/timeradd.3:28 build/C/man2/times.2:41 build/C/man5/tzfile.5:7 build/C/man8/tzselect.8:6 build/C/man3/tzset.3:34 build/C/man2/utime.2:34 build/C/man2/utimensat.2:29 build/C/man8/zdump.8:6 build/C/man8/zic.8:6
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:29
#, no-wrap
msgid ""
"B<int adjtime(const struct timeval *>I<delta>B<, struct timeval "
"*>I<olddelta>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:34 build/C/man3/clock_getcpuclockid.3:40 build/C/man2/clock_getres.2:49 build/C/man2/clock_nanosleep.2:42 build/C/man3/ctime.3:63 build/C/man3/dysize.3:35 build/C/man3/futimes.3:40 build/C/man3/getdate.3:45 build/C/man2/gettimeofday.2:56 build/C/man2/nanosleep.2:46 build/C/man2/stime.2:41 build/C/man3/timegm.3:38 build/C/man3/timeradd.3:48 build/C/man3/tzset.3:48 build/C/man2/utimensat.2:43
msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:38
msgid "B<adjtime>(): _BSD_SOURCE"
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:38 build/C/man2/adjtimex.2:36 build/C/man3/clock.3:36 build/C/man3/clock_getcpuclockid.3:47 build/C/man2/clock_getres.2:59 build/C/man2/clock_nanosleep.2:49 build/C/man3/ctime.3:75 build/C/man3/difftime.3:37 build/C/man3/dysize.3:39 build/C/man3/ftime.3:38 build/C/man3/futimes.3:45 build/C/man3/getdate.3:60 build/C/man2/gettimeofday.2:60 build/C/man2/nanosleep.2:50 build/C/man4/rtc.4:36 build/C/man2/stime.2:45 build/C/man3/strftime.3:45 build/C/man3/strptime.3:39 build/C/man1/time.1:12 build/C/man2/time.2:36 build/C/man7/time.7:29 build/C/man3/timegm.3:43 build/C/man3/timeradd.3:52 build/C/man2/times.2:45 build/C/man5/tzfile.5:9 build/C/man8/tzselect.8:8 build/C/man3/tzset.3:61 build/C/man2/utime.2:46 build/C/man2/utimensat.2:68 build/C/man8/zdump.8:13 build/C/man8/zic.8:30
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:47
msgid ""
"The B<adjtime>()  function gradually adjusts the system clock (as returned "
"by B<gettimeofday>(2)).  The amount of time by which the clock is to be "
"adjusted is specified in the structure pointed to by I<delta>.  This "
"structure has the following form:"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:54 build/C/man2/gettimeofday.2:79 build/C/man3/timeradd.3:65
#, no-wrap
msgid ""
"struct timeval {\n"
"    time_t      tv_sec;     /* seconds */\n"
"    suseconds_t tv_usec;    /* microseconds */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:66
msgid ""
"If the adjustment in I<delta> is positive, then the system clock is speeded "
"up by some small percentage (i.e., by adding a small amount of time to the "
"clock value in each second) until the adjustment has been completed.  If the "
"adjustment in I<delta> is negative, then the clock is slowed down in a "
"similar fashion."
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:76
msgid ""
"If a clock adjustment from an earlier B<adjtime>()  call is already in "
"progress at the time of a later B<adjtime>()  call, and I<delta> is not NULL "
"for the later call, then the earlier adjustment is stopped, but any already "
"completed part of that adjustment is not undone."
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:82
msgid ""
"If I<olddelta> is not NULL, then the buffer that it points to is used to "
"return the amount of time remaining from any previous adjustment that has "
"not yet been completed."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:82 build/C/man2/adjtimex.2:92 build/C/man3/clock.3:40 build/C/man3/clock_getcpuclockid.3:58 build/C/man2/clock_getres.2:151 build/C/man2/clock_nanosleep.2:144 build/C/man3/ctime.3:275 build/C/man3/ftime.3:68 build/C/man3/futimes.3:61 build/C/man3/getdate.3:132 build/C/man2/gettimeofday.2:136 build/C/man2/nanosleep.2:101 build/C/man2/stime.2:53 build/C/man3/strftime.3:308 build/C/man3/strptime.3:274 build/C/man2/time.2:46 build/C/man3/timeradd.3:138 build/C/man2/times.2:101 build/C/man2/utime.2:120 build/C/man2/utimensat.2:225
#, no-wrap
msgid "RETURN VALUE"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:88
msgid ""
"On success, B<adjtime>()  returns 0.  On failure, -1 is returned, and "
"I<errno> is set to indicate the error."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:88 build/C/man2/adjtimex.2:112 build/C/man3/clock_getcpuclockid.3:63 build/C/man2/clock_getres.2:159 build/C/man2/clock_nanosleep.2:150 build/C/man3/futimes.3:66 build/C/man3/getdate.3:148 build/C/man2/gettimeofday.2:143 build/C/man2/nanosleep.2:109 build/C/man2/stime.2:58 build/C/man2/time.2:50 build/C/man3/timeradd.3:143 build/C/man2/times.2:110 build/C/man2/utime.2:125 build/C/man2/utimensat.2:234
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: TP
#: build/C/man3/adjtime.3:89 build/C/man2/adjtimex.2:117 build/C/man2/clock_getres.2:164 build/C/man2/clock_nanosleep.2:160 build/C/man2/clock_nanosleep.2:167 build/C/man2/gettimeofday.2:151 build/C/man2/nanosleep.2:121 build/C/man2/utimensat.2:307 build/C/man2/utimensat.2:311 build/C/man2/utimensat.2:322
#, no-wrap
msgid "B<EINVAL>"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:94
msgid "The adjustment in I<delta> is outside the permitted range."
msgstr ""

#. type: TP
#: build/C/man3/adjtime.3:94 build/C/man2/adjtimex.2:134 build/C/man3/clock_getcpuclockid.3:70 build/C/man2/clock_getres.2:172 build/C/man2/gettimeofday.2:154 build/C/man2/stime.2:62 build/C/man2/utime.2:149 build/C/man2/utimensat.2:365
#, no-wrap
msgid "B<EPERM>"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:100
msgid ""
"The caller does not have sufficient privilege to adjust the time.  Under "
"Linux the B<CAP_SYS_TIME> capability is required."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:100 build/C/man2/adjtimex.2:141 build/C/man3/clock.3:48 build/C/man3/clock_getcpuclockid.3:86 build/C/man2/clock_getres.2:176 build/C/man2/clock_nanosleep.2:179 build/C/man3/ctime.3:280 build/C/man3/difftime.3:46 build/C/man3/dysize.3:49 build/C/man3/ftime.3:71 build/C/man3/futimes.3:87 build/C/man3/getdate.3:193 build/C/man2/gettimeofday.2:161 build/C/man2/nanosleep.2:128 build/C/man2/stime.2:68 build/C/man3/strftime.3:329 build/C/man3/strptime.3:288 build/C/man2/time.2:55 build/C/man3/timegm.3:52 build/C/man3/timeradd.3:145 build/C/man2/times.2:115 build/C/man3/tzset.3:214 build/C/man2/utime.2:162 build/C/man2/utimensat.2:421
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:102
msgid "4.3BSD, System V."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:102 build/C/man3/clock.3:54 build/C/man3/clock_getcpuclockid.3:88 build/C/man2/clock_getres.2:193 build/C/man2/clock_nanosleep.2:181 build/C/man3/ctime.3:299 build/C/man3/difftime.3:48 build/C/man3/dysize.3:51 build/C/man3/getdate.3:195 build/C/man2/gettimeofday.2:172 build/C/man2/nanosleep.2:130 build/C/man4/rtc.4:301 build/C/man3/strftime.3:353 build/C/man3/strptime.3:290 build/C/man2/time.2:61 build/C/man3/timegm.3:56 build/C/man2/times.2:117 build/C/man3/tzset.3:216 build/C/man2/utime.2:171 build/C/man2/utimensat.2:426 build/C/man8/zic.8:408
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:113
msgid ""
"The adjustment that B<adjtime>()  makes to the clock is carried out in such "
"a manner that the clock is always monotonically increasing.  Using "
"B<adjtime>()  to adjust the time prevents the problems that can be caused "
"for certain applications (e.g., B<make>(1))  by abrupt positive or negative "
"jumps in the system time."
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:123
msgid ""
"B<adjtime>()  is intended to be used to make small adjustments to the system "
"time.  Most systems impose a limit on the adjustment that can be specified "
"in I<delta>.  In the glibc implementation, I<delta> must be less than or "
"equal to (INT_MAX / 1000000 - 2)  and greater than or equal to (INT_MIN / "
"1000000 + 2)  (respectively 2145 and -2145 seconds on i386)."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:123 build/C/man2/clock_getres.2:225 build/C/man3/ftime.3:86 build/C/man2/nanosleep.2:193 build/C/man3/strftime.3:419 build/C/man1/time.1:249 build/C/man2/times.2:193 build/C/man2/utimensat.2:460
#, no-wrap
msgid "BUGS"
msgstr ""

#.  http://sourceware.org/bugzilla/show_bug?id=2449
#.  http://bugzilla.kernel.org/show_bug.cgi?id=6761
#.  Thanks to the new adjtimex() ADJ_OFFSET_SS_READ flag
#. type: Plain text
#: build/C/man3/adjtime.3:139
msgid ""
"A longstanding bug meant that if I<delta> was specified as NULL, no valid "
"information about the outstanding clock adjustment was returned in "
"I<olddelta>.  (In this circumstance, B<adjtime>()  should return the "
"outstanding clock adjustment, without changing it.)  This bug is fixed on "
"systems with glibc 2.8 or later and Linux kernel 2.6.26 or later."
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:139 build/C/man2/adjtimex.2:149 build/C/man3/clock.3:84 build/C/man3/clock_getcpuclockid.3:147 build/C/man2/clock_getres.2:235 build/C/man2/clock_nanosleep.2:245 build/C/man3/ctime.3:360 build/C/man3/difftime.3:65 build/C/man3/dysize.3:55 build/C/man3/ftime.3:95 build/C/man3/futimes.3:90 build/C/man3/getdate.3:298 build/C/man2/gettimeofday.2:244 build/C/man2/nanosleep.2:206 build/C/man4/rtc.4:330 build/C/man2/stime.2:70 build/C/man3/strftime.3:511 build/C/man3/strptime.3:408 build/C/man1/time.1:302 build/C/man2/time.2:76 build/C/man7/time.7:174 build/C/man3/timegm.3:97 build/C/man3/timeradd.3:148 build/C/man2/times.2:208 build/C/man5/tzfile.5:149 build/C/man8/tzselect.8:44 build/C/man3/tzset.3:231 build/C/man2/utime.2:181 build/C/man2/utimensat.2:606 build/C/man8/zdump.8:39 build/C/man8/zic.8:414
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:143
msgid "B<adjtimex>(2), B<gettimeofday>(2), B<time>(7)"
msgstr ""

#. type: SH
#: build/C/man3/adjtime.3:143 build/C/man2/adjtimex.2:154 build/C/man3/clock.3:88 build/C/man3/clock_getcpuclockid.3:152 build/C/man2/clock_getres.2:247 build/C/man2/clock_nanosleep.2:252 build/C/man3/ctime.3:372 build/C/man3/difftime.3:72 build/C/man3/dysize.3:57 build/C/man3/ftime.3:98 build/C/man3/futimes.3:94 build/C/man3/getdate.3:304 build/C/man2/gettimeofday.2:254 build/C/man2/nanosleep.2:213 build/C/man4/rtc.4:341 build/C/man2/stime.2:74 build/C/man3/strftime.3:518 build/C/man3/strptime.3:414 build/C/man1/time.1:306 build/C/man2/time.2:82 build/C/man7/time.7:204 build/C/man3/timegm.3:102 build/C/man3/timeradd.3:151 build/C/man2/times.2:215 build/C/man5/tzfile.5:151 build/C/man8/tzselect.8:49 build/C/man3/tzset.3:238 build/C/man2/utime.2:188 build/C/man2/utimensat.2:615 build/C/man8/zdump.8:43 build/C/man8/zic.8:418
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: build/C/man3/adjtime.3:150 build/C/man2/adjtimex.2:161 build/C/man3/clock.3:95 build/C/man3/clock_getcpuclockid.3:159 build/C/man2/clock_getres.2:254 build/C/man2/clock_nanosleep.2:259 build/C/man3/ctime.3:379 build/C/man3/difftime.3:79 build/C/man3/dysize.3:64 build/C/man3/ftime.3:105 build/C/man3/futimes.3:101 build/C/man3/getdate.3:311 build/C/man2/gettimeofday.2:261 build/C/man2/nanosleep.2:220 build/C/man4/rtc.4:348 build/C/man2/stime.2:81 build/C/man3/strftime.3:525 build/C/man3/strptime.3:421 build/C/man1/time.1:313 build/C/man2/time.2:89 build/C/man7/time.7:211 build/C/man3/timegm.3:109 build/C/man3/timeradd.3:158 build/C/man2/times.2:222 build/C/man5/tzfile.5:158 build/C/man8/tzselect.8:56 build/C/man3/tzset.3:245 build/C/man2/utime.2:195 build/C/man2/utimensat.2:622 build/C/man8/zdump.8:50 build/C/man8/zic.8:425
msgid ""
"This page is part of release 3.40 of the Linux I<man-pages> project.  A "
"description of the project, and information about reporting bugs, can be "
"found at http://www.kernel.org/doc/man-pages/."
msgstr ""

#. type: TH
#: build/C/man2/adjtimex.2:29
#, no-wrap
msgid "ADJTIMEX"
msgstr ""

#. type: TH
#: build/C/man2/adjtimex.2:29
#, no-wrap
msgid "2004-05-27"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:32
msgid "adjtimex - tune kernel clock"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:34
msgid "B<#include E<lt>sys/timex.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:36
msgid "B<int adjtimex(struct timex *>I<buf>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:46
msgid ""
"Linux uses David L. Mills' clock adjustment algorithm (see RFC\\ 1305).  The "
"system call B<adjtimex>()  reads and optionally sets adjustment parameters "
"for this algorithm.  It takes a pointer to a I<timex> structure, updates "
"kernel parameters from field values, and returns the same structure with "
"current kernel values.  This structure is declared as follows:"
msgstr ""

#.  FIXME -- what is the scaling unit?  2^16 ?
#. type: Plain text
#: build/C/man2/adjtimex.2:64
#, no-wrap
msgid ""
"struct timex {\n"
"    int modes;           /* mode selector */\n"
"    long offset;         /* time offset (usec) */\n"
"    long freq;           /* frequency offset (scaled ppm) */\n"
"    long maxerror;       /* maximum error (usec) */\n"
"    long esterror;       /* estimated error (usec) */\n"
"    int status;          /* clock command/status */\n"
"    long constant;       /* pll time constant */\n"
"    long precision;      /* clock precision (usec) (read-only) */\n"
"    long tolerance;      /* clock frequency tolerance (ppm)\n"
"                            (read-only) */\n"
"    struct timeval time; /* current time (read-only) */\n"
"    long tick;           /* usecs between clock ticks */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:73
msgid ""
"The I<modes> field determines which parameters, if any, to set.  It may "
"contain a bitwise-I<or> combination of zero or more of the following bits:"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:84
#, no-wrap
msgid ""
"#define ADJ_OFFSET            0x0001 /* time offset */\n"
"#define ADJ_FREQUENCY         0x0002 /* frequency offset */\n"
"#define ADJ_MAXERROR          0x0004 /* maximum time error */\n"
"#define ADJ_ESTERROR          0x0008 /* estimated time error */\n"
"#define ADJ_STATUS            0x0010 /* clock status */\n"
"#define ADJ_TIMECONST         0x0020 /* pll time constant */\n"
"#define ADJ_TICK              0x4000 /* tick value */\n"
"#define ADJ_OFFSET_SINGLESHOT 0x8001 /* old-fashioned adjtime() */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:90
msgid ""
"Ordinary users are restricted to a zero value for I<mode>.  Only the "
"superuser may set any parameters."
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:96
msgid "On success, B<adjtimex>()  returns the clock state:"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:105
#, no-wrap
msgid ""
"#define TIME_OK   0 /* clock synchronized */\n"
"#define TIME_INS  1 /* insert leap second */\n"
"#define TIME_DEL  2 /* delete leap second */\n"
"#define TIME_OOP  3 /* leap second in progress */\n"
"#define TIME_WAIT 4 /* leap second has occurred */\n"
"#define TIME_BAD  5 /* clock not synchronized */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:112
msgid "On failure, B<adjtimex>()  returns -1 and sets I<errno>."
msgstr ""

#. type: TP
#: build/C/man2/adjtimex.2:113 build/C/man2/clock_getres.2:160 build/C/man2/clock_nanosleep.2:151 build/C/man2/gettimeofday.2:144 build/C/man2/nanosleep.2:110 build/C/man2/stime.2:59 build/C/man2/time.2:51 build/C/man2/times.2:111 build/C/man2/utimensat.2:297
#, no-wrap
msgid "B<EFAULT>"
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:117
msgid "I<buf> does not point to writable memory."
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:134
msgid ""
"An attempt is made to set I<buf.offset> to a value outside the range -131071 "
"to +131071, or to set I<buf.status> to a value other than those listed "
"above, or to set I<buf.tick> to a value outside the range 900000/B<HZ> to "
"1100000/B<HZ>, where B<HZ> is the system timer interrupt frequency."
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:141
msgid ""
"I<buf.mode> is nonzero and the caller does not have sufficient privilege.  "
"Under Linux the B<CAP_SYS_TIME> capability is required."
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:149
msgid ""
"B<adjtimex>()  is Linux-specific and should not be used in programs intended "
"to be portable.  See B<adjtime>(3)  for a more portable, but less flexible, "
"method of adjusting the system clock."
msgstr ""

#. type: Plain text
#: build/C/man2/adjtimex.2:154
msgid "B<settimeofday>(2), B<adjtime>(3), B<capabilities>(7), B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man3/clock.3:27
#, no-wrap
msgid "CLOCK"
msgstr ""

#. type: TH
#: build/C/man3/clock.3:27
#, no-wrap
msgid "2008-08-28"
msgstr ""

#. type: TH
#: build/C/man3/clock.3:27 build/C/man3/difftime.3:28 build/C/man3/dysize.3:24 build/C/man3/ftime.3:31 build/C/man3/strftime.3:35 build/C/man3/strptime.3:29 build/C/man3/timegm.3:23
#, no-wrap
msgid "GNU"
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:30
msgid "clock - Determine processor time"
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:33 build/C/man3/ctime.3:40 build/C/man3/difftime.3:34 build/C/man3/strftime.3:41 build/C/man3/timegm.3:29 build/C/man3/tzset.3:37
#, no-wrap
msgid "B<#include E<lt>time.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:35
#, no-wrap
msgid "B<clock_t clock(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:40
msgid ""
"The B<clock>()  function returns an approximation of processor time used by "
"the program."
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:48
msgid ""
"The value returned is the CPU time used so far as a I<clock_t>; to get the "
"number of seconds used, divide by B<CLOCKS_PER_SEC>.  If the processor time "
"used is not available or its value cannot be represented, the function "
"returns the value I<(clock_t)\\ -1>."
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:54
msgid ""
"C89, C99, POSIX.1-2001.  POSIX requires that B<CLOCKS_PER_SEC> equals "
"1000000 independent of the actual resolution."
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:59
msgid ""
"The C standard allows for arbitrary values at the start of the program; "
"subtract the value returned from a call to B<clock>()  at the start of the "
"program to get maximum portability."
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:65
msgid ""
"Note that the time can wrap around.  On a 32-bit system where "
"B<CLOCKS_PER_SEC> equals 1000000 this function will return the same value "
"approximately every 72 minutes."
msgstr ""

#.  I have seen this behavior on Irix 6.3, and the OSF/1, HP/UX, and
#.  Solaris manual pages say that clock() also does this on those systems.
#.  POSIX.1-2001 doesn't explicitly allow this, nor is there an
#.  explicit prohibition. -- MTK
#. type: Plain text
#: build/C/man3/clock.3:84
msgid ""
"On several other implementations, the value returned by B<clock>()  also "
"includes the times of any children whose status has been collected via "
"B<wait>(2)  (or another wait-type call).  Linux does not include the times "
"of waited-for children in the value returned by B<clock>().  The B<times>(2)  "
"function, which explicitly returns (separate) information about the caller "
"and its children, may be preferable."
msgstr ""

#. type: Plain text
#: build/C/man3/clock.3:88
msgid "B<clock_gettime>(2), B<getrusage>(2), B<times>(2)"
msgstr ""

#. type: TH
#: build/C/man3/clock_getcpuclockid.3:24
#, no-wrap
msgid "CLOCK_GETCPUCLOCKID"
msgstr ""

#. type: TH
#: build/C/man3/clock_getcpuclockid.3:24
#, no-wrap
msgid "2010-09-10"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:27
msgid "clock_getcpuclockid - obtain ID of a process CPU-time clock"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:29 build/C/man2/clock_getres.2:37 build/C/man2/clock_nanosleep.2:29 build/C/man3/dysize.3:29 build/C/man3/getdate.3:33 build/C/man3/getdate.3:39 build/C/man2/nanosleep.2:40 build/C/man2/stime.2:35 build/C/man3/strptime.3:36 build/C/man2/time.2:34
msgid "B<#include E<lt>time.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:32
#, no-wrap
msgid "B<int clock_getcpuclockid(pid_t >I<pid>B<, clockid_t *>I<clock_id>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:35 build/C/man2/clock_getres.2:45 build/C/man2/clock_nanosleep.2:37
msgid "Link with I<-lrt>."
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:43
msgid "B<clock_getcpuclockid>():"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:45 build/C/man2/clock_nanosleep.2:47
msgid "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:58
msgid ""
"The B<clock_getcpuclockid>()  function obtains the ID of the CPU-time clock "
"of the process whose ID is I<pid>, and returns it in the location pointed to "
"by I<clock_id>.  If I<pid> is zero, then the clock ID of the CPU-time clock "
"of the calling process is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:63
msgid ""
"On success, B<clock_getcpuclockid>()  returns 0; on error, it returns one of "
"the positive error numbers listed in ERRORS."
msgstr ""

#. type: TP
#: build/C/man3/clock_getcpuclockid.3:64 build/C/man3/futimes.3:75
#, no-wrap
msgid "B<ENOSYS>"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:70
msgid ""
"The kernel does not support obtaining the per-process CPU-time clock of "
"another process, and I<pid> does not specify the calling process."
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:78
msgid ""
"The caller does not have permission to access the CPU-time clock of the "
"process specified by I<pid>.  (Specified as an optional error in "
"POSIX.1-2001; does not occur on Linux unless the kernel does not support "
"obtaining the per-process CPU-time clock of another process.)"
msgstr ""

#. type: TP
#: build/C/man3/clock_getcpuclockid.3:78 build/C/man2/utimensat.2:408
#, no-wrap
msgid "B<ESRCH>"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:82
msgid "There is no process with the ID I<pid>."
msgstr ""

#. type: SH
#: build/C/man3/clock_getcpuclockid.3:82 build/C/man2/clock_nanosleep.2:174 build/C/man3/futimes.3:80 build/C/man2/utimensat.2:413
#, no-wrap
msgid "VERSIONS"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:86
msgid ""
"The B<clock_getcpuclockid>()  function is available in glibc since version "
"2.2."
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:88 build/C/man2/clock_nanosleep.2:181 build/C/man3/getdate.3:195 build/C/man2/nanosleep.2:130
msgid "POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:98
msgid ""
"Calling B<clock_gettime>(2)  with the clock ID obtained by a call to "
"B<clock_getcpuclockid>()  with a I<pid> of 0, is the same as using the clock "
"ID B<CLOCK_PROCESS_CPUTIME_ID>."
msgstr ""

#. type: SH
#: build/C/man3/clock_getcpuclockid.3:98 build/C/man3/getdate.3:209 build/C/man3/strftime.3:450 build/C/man3/strptime.3:382
#, no-wrap
msgid "EXAMPLE"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:105
msgid ""
"The example program below obtains the CPU-time clock ID of the process whose "
"ID is given on the command line, and then uses B<clock_gettime>(2)  to "
"obtain the time on that clock.  An example run is the following:"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:110
#, no-wrap
msgid ""
"$B< ./a.out 1>                 # Show CPU clock of init process\n"
"CPU-time clock for PID 1 is 2.213466748 seconds\n"
msgstr ""

#. type: SS
#: build/C/man3/clock_getcpuclockid.3:112 build/C/man3/getdate.3:260
#, no-wrap
msgid "Program source"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:120
#, no-wrap
msgid ""
"#define _XOPEN_SOURCE 600\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>unistd.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>time.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:126
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    clockid_t clockid;\n"
"    struct timespec ts;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:131
#, no-wrap
msgid ""
"    if (argc != 2) {\n"
"        fprintf(stderr, \"%s E<lt>process-IDE<gt>\\en\", argv[0]);\n"
"\texit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:136
#, no-wrap
msgid ""
"    if (clock_getcpuclockid(atoi(argv[1]), &clockid) != 0) {\n"
"\tperror(\"clock_getcpuclockid\");\n"
"\texit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:141
#, no-wrap
msgid ""
"    if (clock_gettime(clockid, &ts) == -1) {\n"
"\tperror(\"clock_gettime\");\n"
"\texit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:146
#, no-wrap
msgid ""
"    printf(\"CPU-time clock for PID %s is %ld.%09ld seconds\\en\",\n"
"\t    argv[1], (long) ts.tv_sec, (long) ts.tv_nsec);\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clock_getcpuclockid.3:152
msgid ""
"B<clock_getres>(2), B<timer_create>(2), B<pthread_getcpuclockid>(3), "
"B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man2/clock_getres.2:32
#, no-wrap
msgid "CLOCK_GETRES"
msgstr ""

#. type: TH
#: build/C/man2/clock_getres.2:32
#, no-wrap
msgid "2012-04-25"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:35
msgid "clock_getres, clock_gettime, clock_settime - clock and time functions"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:39
msgid "B<int clock_getres(clockid_t >I<clk_id>B<, struct timespec *>I<res>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:41
msgid "B<int clock_gettime(clockid_t >I<clk_id>B<, struct timespec *>I<tp>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:43
msgid ""
"B<int clock_settime(clockid_t >I<clk_id>B<, const struct timespec "
"*>I<tp>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:55
msgid "B<clock_getres>(), B<clock_gettime>(), B<clock_settime>():"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:57
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 199309L"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:78
msgid ""
"The function B<clock_getres>()  finds the resolution (precision) of the "
"specified clock I<clk_id>, and, if I<res> is non-NULL, stores it in the "
"I<struct timespec> pointed to by I<res>.  The resolution of clocks depends "
"on the implementation and cannot be configured by a particular process.  If "
"the time value pointed to by the argument I<tp> of B<clock_settime>()  is "
"not a multiple of I<res>, then it is truncated to a multiple of I<res>."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:85
msgid ""
"The functions B<clock_gettime>()  and B<clock_settime>()  retrieve and set "
"the time of the specified clock I<clk_id>."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:94
msgid ""
"The I<res> and I<tp> arguments are I<timespec> structures, as specified in "
"I<E<lt>time.hE<gt>>:"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:101
#, no-wrap
msgid ""
"struct timespec {\n"
"    time_t   tv_sec;        /* seconds */\n"
"    long     tv_nsec;       /* nanoseconds */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:109
msgid ""
"The I<clk_id> argument is the identifier of the particular clock on which to "
"act.  A clock may be system-wide and hence visible for all processes, or "
"per-process if it measures time only within a single process."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:116
msgid ""
"All implementations support the system-wide real-time clock, which is "
"identified by B<CLOCK_REALTIME>.  Its time represents seconds and "
"nanoseconds since the Epoch.  When its time is changed, timers for a "
"relative interval are unaffected, but timers for an absolute point in time "
"are affected."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:120
msgid ""
"More clocks may be implemented.  The interpretation of the corresponding "
"time values and the effect on timers is unspecified."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:123
msgid ""
"Sufficiently recent versions of glibc and the Linux kernel support the "
"following clocks:"
msgstr ""

#. type: TP
#: build/C/man2/clock_getres.2:123 build/C/man2/clock_nanosleep.2:78
#, no-wrap
msgid "B<CLOCK_REALTIME>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:127
msgid ""
"System-wide real-time clock.  Setting this clock requires appropriate "
"privileges."
msgstr ""

#. type: TP
#: build/C/man2/clock_getres.2:127 build/C/man2/clock_nanosleep.2:81
#, no-wrap
msgid "B<CLOCK_MONOTONIC>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:136
msgid ""
"Clock that cannot be set and represents monotonic time since some "
"unspecified starting point.  This clock is not affected by discontinuous "
"jumps in the system time (e.g., if the system administrator manually changes "
"the clock), but is affected by the incremental adjustments performed by "
"B<adjtime>(2)  and NTP."
msgstr ""

#. type: TP
#: build/C/man2/clock_getres.2:136
#, no-wrap
msgid "B<CLOCK_MONOTONIC_RAW> (since Linux 2.6.28; Linux-specific)"
msgstr ""

#.  Added in commit 2d42244ae71d6c7b0884b5664cf2eda30fb2ae68, John Stultz
#. type: Plain text
#: build/C/man2/clock_getres.2:145
msgid ""
"Similar to B<CLOCK_MONOTONIC>, but provides access to a raw hardware-based "
"time that is not subject to NTP adjustments or the incremental adjustments "
"performed by B<adjtime>(2)."
msgstr ""

#. type: TP
#: build/C/man2/clock_getres.2:145 build/C/man2/clock_nanosleep.2:87
#, no-wrap
msgid "B<CLOCK_PROCESS_CPUTIME_ID>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:148
msgid "High-resolution per-process timer from the CPU."
msgstr ""

#. type: TP
#: build/C/man2/clock_getres.2:148
#, no-wrap
msgid "B<CLOCK_THREAD_CPUTIME_ID>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:151
msgid "Thread-specific CPU-time clock."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:159
msgid ""
"B<clock_gettime>(), B<clock_settime>()  and B<clock_getres>()  return 0 for "
"success, or -1 for failure (in which case I<errno> is set appropriately)."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:164
msgid "I<tp> points outside the accessible address space."
msgstr ""

#.  Linux also gives this error on attempts to set CLOCK_PROCESS_CPUTIME_ID
#.  and CLOCK_THREAD_CPUTIME_ID, when probably the proper error should be
#.  EPERM.
#. type: Plain text
#: build/C/man2/clock_getres.2:172
msgid "The I<clk_id> specified is not supported on this system."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:176
msgid "B<clock_settime>()  does not have permission to set the clock indicated."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:178 build/C/man3/strptime.3:290
msgid "SUSv2, POSIX.1-2001."
msgstr ""

#. type: SH
#: build/C/man2/clock_getres.2:178
#, no-wrap
msgid "AVAILABILITY"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:193
msgid ""
"On POSIX systems on which these functions are available, the symbol "
"B<_POSIX_TIMERS> is defined in I<E<lt>unistd.hE<gt>> to a value greater than "
"0.  The symbols B<_POSIX_MONOTONIC_CLOCK>, B<_POSIX_CPUTIME>, "
"B<_POSIX_THREAD_CPUTIME> indicate that B<CLOCK_MONOTONIC>, "
"B<CLOCK_PROCESS_CPUTIME_ID>, B<CLOCK_THREAD_CPUTIME_ID> are available.  (See "
"also B<sysconf>(3).)"
msgstr ""

#. type: SS
#: build/C/man2/clock_getres.2:194
#, no-wrap
msgid "Note for SMP systems"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:205
msgid ""
"The B<CLOCK_PROCESS_CPUTIME_ID> and B<CLOCK_THREAD_CPUTIME_ID> clocks are "
"realized on many platforms using timers from the CPUs (TSC on i386, AR.ITC "
"on Itanium).  These registers may differ between CPUs and as a consequence "
"these clocks may return B<bogus results> if a process is migrated to another "
"CPU."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:216
msgid ""
"If the CPUs in an SMP system have different clock sources then there is no "
"way to maintain a correlation between the timer registers since each CPU "
"will run at a slightly different frequency.  If that is the case then "
"I<clock_getcpuclockid(0)> will return B<ENOENT> to signify this condition.  "
"The two clocks will then only be useful if it can be ensured that a process "
"stays on a certain CPU."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:225
msgid ""
"The processors in an SMP system do not start all at exactly the same time "
"and therefore the timer registers are typically running at an offset.  Some "
"architectures include code that attempts to limit these offsets on bootup.  "
"However, the code cannot guarantee to accurately tune the offsets.  Glibc "
"contains no provisions to deal with these offsets (unlike the Linux "
"Kernel).  Typically these offsets are small and therefore the effects may be "
"negligible in most cases."
msgstr ""

#.  See http://bugzilla.kernel.org/show_bug.cgi?id=11972
#. type: Plain text
#: build/C/man2/clock_getres.2:235
msgid ""
"According to POSIX.1-2001, a process with \"appropriate privileges\" may set "
"the B<CLOCK_PROCESS_CPUTIME_ID> and B<CLOCK_THREAD_CPUTIME_ID> clocks using "
"B<clock_settime>().  On Linux, these clocks are not settable (i.e., no "
"process has \"appropriate privileges\")."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_getres.2:247
#, no-wrap
msgid ""
"B<date>(1),\n"
"B<adjtime>(2),\n"
"B<gettimeofday>(2),\n"
"B<settimeofday>(2),\n"
"B<time>(2),\n"
"B<clock_getcpuclockid>(3),\n"
"B<ctime>(3),\n"
"B<ftime>(3),\n"
"B<pthread_getcpuclockid>(3),\n"
"B<sysconf>(3),\n"
" time (7)\n"
msgstr ""

#. type: TH
#: build/C/man2/clock_nanosleep.2:24
#, no-wrap
msgid "CLOCK_NANOSLEEP"
msgstr ""

#. type: TH
#: build/C/man2/clock_nanosleep.2:24
#, no-wrap
msgid "2010-12-03"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:27
msgid "clock_nanosleep - high-resolution sleep with specifiable clock"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:34
#, no-wrap
msgid ""
"B<int clock_nanosleep(clockid_t >I<clock_id>B<, int >I<flags>B<,>\n"
"B<                    const struct timespec *>I<request>B<,>\n"
"B<                    struct timespec *>I<remain>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:45
msgid "B<clock_nanosleep>():"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:59
msgid ""
"Like B<nanosleep>(2), B<clock_nanosleep>()  allows the calling thread to "
"sleep for an interval specified with nanosecond precision.  It differs in "
"allowing the caller to select the clock against which the sleep interval is "
"to be measured, and in allowing the sleep interval to be specified as either "
"an absolute or a relative value."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:63
msgid ""
"The time values passed to and returned by this call are specified using "
"I<timespec> structures, defined as follows:"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:70
#, no-wrap
msgid ""
"struct timespec {\n"
"    time_t tv_sec;        /* seconds */\n"
"    long   tv_nsec;       /* nanoseconds [0 .. 999999999] */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:78
msgid ""
"The I<clock_id> argument specifies the clock against which the sleep "
"interval is to be measured.  This argument can have one of the following "
"values:"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:81
msgid "A settable system-wide real-time clock."
msgstr ""

#.  On Linux this clock measures time since boot.
#. type: Plain text
#: build/C/man2/clock_nanosleep.2:87
msgid ""
"A nonsettable, monotonically increasing clock that measures time since some "
"unspecified point in the past that does not change after system startup."
msgstr ""

#.  There is some trickery between glibc and the kernel
#.  to deal with the CLOCK_PROCESS_CPUTIME_ID case.
#. type: Plain text
#: build/C/man2/clock_nanosleep.2:93
msgid ""
"A settable per-process clock that measures CPU time consumed by all threads "
"in the process."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:97
msgid "See B<clock_getres>(2)  for further details on these clocks."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:105
msgid ""
"If I<flags> is 0, then the value specified in I<request> is interpreted as "
"an interval relative to the current value of the clock specified by "
"I<clock_id>."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:120
msgid ""
"If I<flags> is B<TIMER_ABSTIME>, then I<request> is interpreted as an "
"absolute time as measured by the clock, I<clock_id>.  If I<request> is less "
"than or equal to the current value of the clock, then B<clock_nanosleep>()  "
"returns immediately without suspending the calling thread."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:128
msgid ""
"B<clock_nanosleep>()  suspends the execution of the calling thread until "
"either at least the time specified by I<request> has elapsed, or a signal is "
"delivered that causes a signal handler to be called or that terminates the "
"process."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:144
msgid ""
"If the call is interrupted by a signal handler, B<clock_nanosleep>()  fails "
"with the error B<EINTR>.  In addition, if I<remain> is not NULL, and "
"I<flags> was not B<TIMER_ABSTIME>, it returns the remaining unslept time in "
"I<remain>.  This value can then be used to call B<clock_nanosleep>()  again "
"and complete a (relative) sleep."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:150
msgid ""
"On successfully sleeping for the requested interval, B<clock_nanosleep>()  "
"returns 0.  If the call is interrupted by a signal handler or encounters an "
"error, then it returns one of the positive error number listed in ERRORS."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:157
msgid "I<request> or I<remain> specified an invalid address."
msgstr ""

#. type: TP
#: build/C/man2/clock_nanosleep.2:157 build/C/man2/nanosleep.2:113
#, no-wrap
msgid "B<EINTR>"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:160
msgid "The sleep was interrupted by a signal handler."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:167 build/C/man2/nanosleep.2:128
msgid ""
"The value in the I<tv_nsec> field was not in the range 0 to 999999999 or "
"I<tv_sec> was negative."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:174
msgid ""
"I<clock_id> was invalid.  (B<CLOCK_THREAD_CPUTIME_ID> is not a permitted "
"value for I<clock_id>.)"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:179
msgid ""
"The B<clock_nanosleep>()  system call first appeared in Linux 2.6.  Support "
"is available in glibc since version 2.1."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:189
msgid ""
"If the interval specified in I<request> is not an exact multiple of the "
"granularity underlying clock (see B<time>(7)), then the interval will be "
"rounded up to the next multiple.  Furthermore, after the sleep completes, "
"there may still be a delay before the CPU becomes free to once again execute "
"the calling thread."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:204
msgid ""
"Using an absolute timer is useful for preventing timer drift problems of the "
"type described in B<nanosleep>(2).  (Such problems are exacerbated in "
"programs that try to restart a relative sleep that is repeatedly interrupted "
"by signals.)  To perform a relative sleep that avoids these problems, call "
"B<clock_gettime>(2)  for the desired clock, add the desired interval to the "
"returned time value, and then call B<clock_nanosleep>()  with the "
"B<TIMER_ABSTIME> flag."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:211
msgid ""
"B<clock_nanosleep>()  is never restarted after being interrupted by a signal "
"handler, regardless of the use of the B<sigaction>(2)  B<SA_SIGACTION> flag."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:221
msgid ""
"The I<remain> argument is unused, and unnecessary, when I<flags> is "
"B<TIMER_ABSTIME>.  (An absolute sleep can be restarted using the same "
"I<request> argument.)"
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:225
msgid ""
"POSIX.1 specifies that B<clock_nanosleep>()  has no effect on signals "
"dispositions or the signal mask."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:237
msgid ""
"POSIX.1 specifies that after changing the value of the B<CLOCK_REALTIME> "
"clock via B<clock_settime>(2), the new clock value shall be used to "
"determine the time at which a thread blocked on an absolute "
"B<clock_nanosleep>()  will wake up; if the new clock value falls past the "
"end of the sleep interval, then the B<clock_nanosleep>()  call will return "
"immediately."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:245
msgid ""
"POSIX.1 specifies that changing the value of the B<CLOCK_REALTIME> clock via "
"B<clock_settime>(2)  shall have no effect on a thread that is blocked on a "
"relative B<clock_nanosleep>()."
msgstr ""

#. type: Plain text
#: build/C/man2/clock_nanosleep.2:252
msgid ""
"B<clock_getres>(2), B<nanosleep>(2), B<timer_create>(2), B<sleep>(3), "
"B<usleep>(3), B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man3/ctime.3:33
#, no-wrap
msgid "CTIME"
msgstr ""

#. type: TH
#: build/C/man3/ctime.3:33 build/C/man3/difftime.3:28 build/C/man3/ftime.3:31 build/C/man4/rtc.4:29 build/C/man2/stime.2:30 build/C/man7/time.7:26 build/C/man3/timeradd.3:25 build/C/man8/zic.8:3
#, no-wrap
msgid "2010-02-25"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:37
msgid ""
"asctime, ctime, gmtime, localtime, mktime, asctime_r, ctime_r, gmtime_r, "
"localtime_r - transform date and time to broken-down time or ASCII"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:42
#, no-wrap
msgid "B<char *asctime(const struct tm *>I<tm>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:44
#, no-wrap
msgid "B<char *asctime_r(const struct tm *>I<tm>B<, char *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:46
#, no-wrap
msgid "B<char *ctime(const time_t *>I<timep>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:48
#, no-wrap
msgid "B<char *ctime_r(const time_t *>I<timep>B<, char *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:50
#, no-wrap
msgid "B<struct tm *gmtime(const time_t *>I<timep>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:52
#, no-wrap
msgid ""
"B<struct tm *gmtime_r(const time_t *>I<timep>B<, struct tm "
"*>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:54
#, no-wrap
msgid "B<struct tm *localtime(const time_t *>I<timep>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:56
#, no-wrap
msgid ""
"B<struct tm *localtime_r(const time_t *>I<timep>B<, struct tm "
"*>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:58
#, no-wrap
msgid "B<time_t mktime(struct tm *>I<tm>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:70
msgid "B<asctime_r>(), B<ctime_r>(), B<gmtime_r>(), B<localtime_r>():"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:73
msgid ""
"_POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE "
"|| _POSIX_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:85
msgid ""
"The B<ctime>(), B<gmtime>()  and B<localtime>()  functions all take an "
"argument of data type I<time_t> which represents calendar time.  When "
"interpreted as an absolute time value, it represents the number of seconds "
"elapsed since the Epoch, 1970-01-01 00:00:00 +0000 (UTC)."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:93
msgid ""
"The B<asctime>()  and B<mktime>()  functions both take an argument "
"representing broken-down time which is a representation separated into year, "
"month, day, etc."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:96
msgid ""
"Broken-down time is stored in the structure I<tm> which is defined in "
"I<E<lt>time.hE<gt>> as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:110
#, no-wrap
msgid ""
"struct tm {\n"
"    int tm_sec;         /* seconds */\n"
"    int tm_min;         /* minutes */\n"
"    int tm_hour;        /* hours */\n"
"    int tm_mday;        /* day of the month */\n"
"    int tm_mon;         /* month */\n"
"    int tm_year;        /* year */\n"
"    int tm_wday;        /* day of the week */\n"
"    int tm_yday;        /* day in the year */\n"
"    int tm_isdst;       /* daylight saving time */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:114
msgid "The members of the I<tm> structure are:"
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:114
#, no-wrap
msgid "I<tm_sec>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:118
msgid ""
"The number of seconds after the minute, normally in the range 0 to 59, but "
"can be up to 60 to allow for leap seconds."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:118
#, no-wrap
msgid "I<tm_min>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:121
msgid "The number of minutes after the hour, in the range 0 to 59."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:121
#, no-wrap
msgid "I<tm_hour>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:124
msgid "The number of hours past midnight, in the range 0 to 23."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:124
#, no-wrap
msgid "I<tm_mday>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:127
msgid "The day of the month, in the range 1 to 31."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:127
#, no-wrap
msgid "I<tm_mon>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:130
msgid "The number of months since January, in the range 0 to 11."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:130
#, no-wrap
msgid "I<tm_year>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:133
msgid "The number of years since 1900."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:133
#, no-wrap
msgid "I<tm_wday>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:136
msgid "The number of days since Sunday, in the range 0 to 6."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:136
#, no-wrap
msgid "I<tm_yday>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:139
msgid "The number of days since January 1, in the range 0 to 365."
msgstr ""

#. type: TP
#: build/C/man3/ctime.3:139
#, no-wrap
msgid "I<tm_isdst>"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:146
msgid ""
"A flag that indicates whether daylight saving time is in effect at the time "
"described.  The value is positive if daylight saving time is in effect, zero "
"if it is not, and negative if the information is not available."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:153
msgid ""
"The call B<ctime(>I<t>B<)> is equivalent to B<asctime(localtime(>I<t>B<))>.  "
"It converts the calendar time I<t> into a null-terminated string of the form"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:156
msgid "Wed Jun 30 21:49:08 1993\\en"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:177
msgid ""
"The abbreviations for the days of the week are \"Sun\", \"Mon\", \"Tue\", "
"\"Wed\", \"Thu\", \"Fri\", and \"Sat\".  The abbreviations for the months "
"are \"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", "
"\"Sep\", \"Oct\", \"Nov\", and \"Dec\".  The return value points to a "
"statically allocated string which might be overwritten by subsequent calls "
"to any of the date and time functions.  The function also sets the external "
"variables I<tzname>, I<timezone>, and I<daylight> (see B<tzset>(3))  with "
"information about the current timezone.  The reentrant version B<ctime_r>()  "
"does the same, but stores the string in a user-supplied buffer which should "
"have room for at least 26 bytes.  It need not set I<tzname>, I<timezone>, "
"and I<daylight>."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:190
msgid ""
"The B<gmtime>()  function converts the calendar time I<timep> to broken-down "
"time representation, expressed in Coordinated Universal Time (UTC).  It may "
"return NULL when the year does not fit into an integer.  The return value "
"points to a statically allocated struct which might be overwritten by "
"subsequent calls to any of the date and time functions.  The B<gmtime_r>()  "
"function does the same, but stores the data in a user-supplied struct."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:210
msgid ""
"The B<localtime>()  function converts the calendar time I<timep> to "
"broken-down time representation, expressed relative to the user's specified "
"timezone.  The function acts as if it called B<tzset>(3)  and sets the "
"external variables I<tzname> with information about the current timezone, "
"I<timezone> with the difference between Coordinated Universal Time (UTC) and "
"local standard time in seconds, and I<daylight> to a nonzero value if "
"daylight savings time rules apply during some part of the year.  The return "
"value points to a statically allocated struct which might be overwritten by "
"subsequent calls to any of the date and time functions.  The "
"B<localtime_r>()  function does the same, but stores the data in a "
"user-supplied struct.  It need not set I<tzname>, I<timezone>, and "
"I<daylight>."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:222
msgid ""
"The B<asctime>()  function converts the broken-down time value I<tm> into a "
"null-terminated string with the same format as B<ctime>().  The return value "
"points to a statically allocated string which might be overwritten by "
"subsequent calls to any of the date and time functions.  The B<asctime_r>()  "
"function does the same, but stores the string in a user-supplied buffer "
"which should have room for at least 26 bytes."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:247
msgid ""
"The B<mktime>()  function converts a broken-down time structure, expressed "
"as local time, to calendar time representation.  The function ignores the "
"values supplied by the caller in the I<tm_wday> and I<tm_yday> fields.  The "
"value specified in the I<tm_isdst> field informs B<mktime>()  whether or not "
"daylight saving time (DST)  is in effect for the time supplied in the I<tm> "
"structure: a positive value means DST is in effect; zero means that DST is "
"not in effect; and a negative value means that B<mktime>()  should (use "
"timezone information and system databases to)  attempt to determine whether "
"DST is in effect at the specified time."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:267
msgid ""
"The B<mktime>()  function modifies the fields of the I<tm> structure as "
"follows: I<tm_wday> and I<tm_yday> are set to values determined from the "
"contents of the other fields; if structure members are outside their valid "
"interval, they will be normalized (so that, for example, 40 October is "
"changed into 9 November); I<tm_isdst> is set (regardless of its initial "
"value)  to a positive value or to 0, respectively, to indicate whether DST "
"is or is not in effect at the specified time.  Calling B<mktime>()  also "
"sets the external variable I<tzname> with information about the current "
"timezone."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:275
msgid ""
"If the specified broken-down time cannot be represented as calendar time "
"(seconds since the Epoch), B<mktime>()  returns I<(time_t)\\ -1> and does "
"not alter the members of the broken-down time structure."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:280
msgid ""
"Each of these functions returns the value described, or NULL (-1 in case of "
"B<mktime>())  in case an error was detected."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:299
msgid ""
"POSIX.1-2001.  C89 and C99 specify B<asctime>(), B<ctime>(), B<gmtime>(), "
"B<localtime>(), and B<mktime>().  POSIX.1-2008 marks B<asctime>(), "
"B<asctime_r>(), B<ctime>(), and B<ctime_r>()  as obsolete, recommending the "
"use of B<strftime>(3)  instead."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:314
msgid ""
"The four functions B<asctime>(), B<ctime>(), B<gmtime>()  and B<localtime>()  "
"return a pointer to static data and hence are not thread-safe.  Thread-safe "
"versions B<asctime_r>(), B<ctime_r>(), B<gmtime_r>()  and B<localtime_r>()  "
"are specified by SUSv2, and available since libc 5.2.5."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:328
msgid ""
"POSIX.1-2001 says: \"The B<asctime>(), B<ctime>(), B<gmtime>(), and "
"B<localtime>()  functions shall return values in one of two static objects: "
"a broken-down time structure and an array of type I<char>.  Execution of any "
"of the functions may overwrite the information returned in either of these "
"objects by any of the other functions.\" This can occur in the glibc "
"implementation."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:332
msgid ""
"In many implementations, including glibc, a 0 in I<tm_mday> is interpreted "
"as meaning the last day of the preceding month."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:334
msgid "The glibc version of I<struct tm> has additional fields"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:339
#, no-wrap
msgid ""
"long tm_gmtoff;           /* Seconds east of UTC */\n"
"const char *tm_zone;      /* Timezone abbreviation */\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:347
msgid ""
"defined when B<_BSD_SOURCE> was set before including I<E<lt>time.hE<gt>>.  "
"This is a BSD extension, present in 4.3BSD-Reno."
msgstr ""

#.  See http://thread.gmane.org/gmane.comp.time.tz/2034/
#. type: Plain text
#: build/C/man3/ctime.3:360
msgid ""
"According to POSIX.1-2004, B<localtime>()  is required to behave as though "
"B<tzset>(3)  was called, while B<localtime_r>()  does not have this "
"requirement.  For portable code B<tzset>(3)  should be called before "
"B<localtime_r>()."
msgstr ""

#. type: Plain text
#: build/C/man3/ctime.3:372
msgid ""
"B<date>(1), B<gettimeofday>(2), B<time>(2), B<utime>(2), B<clock>(3), "
"B<difftime>(3), B<strftime>(3), B<strptime>(3), B<timegm>(3), B<tzset>(3), "
"B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man3/difftime.3:28
#, no-wrap
msgid "DIFFTIME"
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:31
msgid "difftime - calculate time difference"
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:36
#, no-wrap
msgid "B<double difftime(time_t >I<time1>B<, time_t >I<time0>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:46
msgid ""
"The B<difftime>()  function returns the number of seconds elapsed between "
"time I<time1> and time I<time0>, represented as a I<double>.  Each of the "
"times is specified in calendar time, which means its value is a measurement "
"(in seconds) relative to the Epoch, 1970-01-01 00:00:00 +0000 (UTC)."
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:48
msgid "SVr4, 4.3BSD, C89, C99."
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:53
msgid ""
"On a POSIX system, I<time_t> is an arithmetic type, and one could just "
"define"
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:57
#, no-wrap
msgid "#define difftime(t1,t0) (double)(t1 - t0)\n"
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:65
msgid ""
"when the possible overflow in the subtraction is not a concern.  On other "
"systems, the data type I<time_t> might use some other encoding where "
"subtraction doesn't work directly."
msgstr ""

#. type: Plain text
#: build/C/man3/difftime.3:72
msgid ""
"B<date>(1), B<gettimeofday>(2), B<time>(2), B<ctime>(3), B<gmtime>(3), "
"B<localtime>(3)"
msgstr ""

#. type: TH
#: build/C/man3/dysize.3:24
#, no-wrap
msgid "DYSIZE"
msgstr ""

#. type: TH
#: build/C/man3/dysize.3:24
#, no-wrap
msgid "2010-09-22"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:27
msgid "dysize - get number of days for a given year"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:31
msgid "B<int dysize(int >I<year>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:39
msgid "B<dysize>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:42
msgid ""
"The function returns 365 for a normal year and 366 for a leap year.  The "
"calculation for leap year is based on:"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:44
msgid "(year) %4 == 0 && ((year) %100 != 0 || (year) %400 == 0)"
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:49
msgid ""
"The formula is defined in the macro I<__isleap(year)> also found in "
"I<E<lt>time.hE<gt>>."
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:51
msgid "This function occurs in SunOS 4.x."
msgstr ""

#.  The SCO version of this function had a year-2000 problem.
#. type: Plain text
#: build/C/man3/dysize.3:55
msgid "This is a compatibility function only.  Don't use it in new programs."
msgstr ""

#. type: Plain text
#: build/C/man3/dysize.3:57
msgid "B<strftime>(3)"
msgstr ""

#. type: TH
#: build/C/man3/ftime.3:31
#, no-wrap
msgid "FTIME"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:34
msgid "ftime - return date and time"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:36
msgid "B<#include E<lt>sys/timeb.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:38
msgid "B<int ftime(struct timeb *>I<tp>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:44
msgid ""
"This function returns the current time as seconds and milliseconds since the "
"Epoch, 1970-01-01 00:00:00 +0000 (UTC).  The time is returned in I<tp>, "
"which is declared as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:53
#, no-wrap
msgid ""
"struct timeb {\n"
"    time_t         time;\n"
"    unsigned short millitm;\n"
"    short          timezone;\n"
"    short          dstflag;\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:65
msgid ""
"Here I<time> is the number of seconds since the Epoch, and I<millitm> is the "
"number of milliseconds since I<time> seconds since the Epoch.  The "
"I<timezone> field is the local timezone measured in minutes of time west of "
"Greenwich (with a negative value indicating minutes east of Greenwich).  The "
"I<dstflag> field is a flag that, if nonzero, indicates that Daylight Saving "
"time applies locally during the appropriate part of the year."
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:68
msgid ""
"POSIX.1-2001 says that the contents of the I<timezone> and I<dstflag> fields "
"are unspecified; avoid relying on them."
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:71
msgid ""
"This function always returns 0.  (POSIX.1-2001 specifies, and some systems "
"document, a -1 error return.)"
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:75
msgid "4.2BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of B<ftime>()."
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:86
msgid ""
"This function is obsolete.  Don't use it.  If the time in seconds suffices, "
"B<time>(2)  can be used; B<gettimeofday>(2)  gives microseconds; "
"B<clock_gettime>(2)  gives nanoseconds but is not as widely available."
msgstr ""

#.  .SH HISTORY
#.  The
#.  .BR ftime ()
#.  function appeared in 4.2BSD.
#. type: Plain text
#: build/C/man3/ftime.3:95
msgid ""
"Under libc4 and libc5 the I<millitm> field is meaningful.  But early glibc2 "
"is buggy and returns 0 there; glibc 2.1.1 is correct again."
msgstr ""

#. type: Plain text
#: build/C/man3/ftime.3:98
msgid "B<gettimeofday>(2), B<time>(2)"
msgstr ""

#. type: TH
#: build/C/man3/futimes.3:25
#, no-wrap
msgid "FUTIMES"
msgstr ""

#. type: TH
#: build/C/man3/futimes.3:25
#, no-wrap
msgid "2008-04-07"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:28
msgid "futimes, lutimes - change file timestamps"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:31 build/C/man2/gettimeofday.2:46 build/C/man3/timeradd.3:31 build/C/man2/utime.2:43
#, no-wrap
msgid "B<#include E<lt>sys/time.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:33
#, no-wrap
msgid "B<int futimes(int >I<fd>B<, const struct timeval >I<tv>B<[2]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:35
#, no-wrap
msgid ""
"B<int lutimes(const char *>I<filename>B<, const struct timeval "
">I<tv>B<[2]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:45
msgid "B<futimes>(), B<lutimes>(): _BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:53
msgid ""
"B<futimes>()  changes the access and modification times of a file in the "
"same way as B<utimes>(2), with the difference that the file whose timestamps "
"are to be changed is specified via a file descriptor, I<fd>, rather than via "
"a pathname."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:61
msgid ""
"B<lutimes>()  changes the access and modification times of a file in the "
"same way as B<utimes>(2), with the difference that if I<filename> refers to "
"a symbolic link, then the link is not dereferenced: instead, the timestamps "
"of the symbolic link are changed."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:66 build/C/man2/stime.2:58 build/C/man2/utime.2:125
msgid ""
"On success, zero is returned.  On error, -1 is returned, and I<errno> is set "
"appropriately."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:71
msgid ""
"Errors are as for B<utimes>(2), with the following additions for "
"B<futimes>():"
msgstr ""

#. type: TP
#: build/C/man3/futimes.3:71 build/C/man2/utimensat.2:283 build/C/man2/utimensat.2:288
#, no-wrap
msgid "B<EBADF>"
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:75
msgid "I<fd> is not a valid file descriptor."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:80
msgid "The I</proc> file system could not be accessed."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:87
msgid ""
"B<futimes>()  is available since glibc 2.3.  B<lutimes>()  is available "
"since glibc 2.6, and is implemented using the B<utimensat>(2)  system call, "
"which is supported since kernel 2.6.22."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:90
msgid ""
"These functions are not specified in any standard.  Other than Linux, they "
"are only available on the BSDs."
msgstr ""

#. type: Plain text
#: build/C/man3/futimes.3:94
msgid "B<utime>(2), B<utimensat>(2), B<symlink>(7)"
msgstr ""

#. type: TH
#: build/C/man3/getdate.3:28
#, no-wrap
msgid "GETDATE"
msgstr ""

#. type: TH
#: build/C/man3/getdate.3:28
#, no-wrap
msgid "2010-09-20"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:31
msgid "getdate, getdate_r - convert a date-plus-time string to broken-down time"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:35
msgid "B<struct tm *getdate(const char *>I<string>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:37
msgid "B<extern int getdate_err;>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:41
msgid "B<int getdate_r(const char *>I<string>B<, struct tm *>I<res>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:48
msgid "B<getdate>():"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:52
msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:55
msgid "B<getdate_r>():"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:58 build/C/man2/utimensat.2:65
msgid "_GNU_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:76
msgid ""
"The function B<getdate>()  converts a string representation of a date and "
"time, contained in the buffer pointed to by I<string>, into a broken-down "
"time.  The broken-down time is stored in a I<tm> structure, and a pointer to "
"this structure is returned as the function result.  This I<tm> structure is "
"allocated in static storage, and consequently it will be overwritten by "
"further calls to B<getdate>()."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:88
msgid ""
"In contrast to B<strptime>(3), (which has a I<format> argument), "
"B<getdate>()  uses the formats found in the file whose full pathname is "
"given in the environment variable B<DATEMSK>.  The first line in the file "
"that matches the given input string is used for the conversion."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:92
msgid ""
"The matching is done case insensitively.  Superfluous whitespace, either in "
"the pattern or in the string to be converted, is ignored."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:96
msgid ""
"The conversion specifications that a pattern can contain are those given for "
"B<strptime>(3).  One more conversion specification is specified in "
"POSIX.1-2001:"
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:96 build/C/man3/strftime.3:254 build/C/man3/strptime.3:356 build/C/man1/time.1:173
#, no-wrap
msgid "B<%Z>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:100
msgid "Timezone name.  This is not implemented in glibc."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:109
msgid ""
"When B<%Z> is given, the structure containing the broken-down time is "
"initialized with values corresponding to the current time in the given "
"timezone.  Otherwise, the structure is initialized to the broken-down time "
"corresponding to the current local time (as by a call to B<localtime>(3))."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:112
msgid ""
"When only the weekday is given, the day is taken to be the first such day on "
"or after today."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:116
msgid ""
"When only the month is given (and no year), the month is taken to be the "
"first such month equal to or after the current month.  If no day is given, "
"it is the first day of the month."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:119
msgid ""
"When no hour, minute and second are given, the current hour, minute and "
"second are taken."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:122
msgid ""
"If no date is given, but we know the hour, then that hour is taken to be the "
"first such hour equal to or after the current hour."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:132
msgid ""
"B<getdate_r>()  is a GNU extension that provides a reentrant version of "
"B<getdate>().  Rather than using a global variable to report errors and a "
"static buffer to return the broken down time, it returns errors via the "
"function result value, and returns the resulting broken-down time in the "
"caller-allocated buffer pointed to by the argument I<res>."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:143
msgid ""
"When successful, B<getdate>()  returns a pointer to a I<struct tm>.  "
"Otherwise, it returns NULL and sets the global variable I<getdate_err> to "
"one of the error numbers shown below.  Changes to I<errno> are unspecified."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:148
msgid ""
"On success B<getdate_r>()  returns 0; on error it returns one of the error "
"numbers shown below."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:155
msgid ""
"The following errors are returned via I<getdate_err> (for B<getdate>())  or "
"as the function result (for B<getdate_r>()):"
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:155
#, no-wrap
msgid "B<1>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:160
msgid ""
"The B<DATEMSK> environment variable is not defined, or its value is an empty "
"string."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:160
#, no-wrap
msgid "B<2>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:165
msgid "The template file specified by B<DATEMSK> cannot be opened for reading."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:165
#, no-wrap
msgid "B<3>"
msgstr ""

#.  stat()
#. type: Plain text
#: build/C/man3/getdate.3:169
msgid "Failed to get file status information."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:169
#, no-wrap
msgid "B<4>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:172
msgid "The template file is not a regular file."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:172
#, no-wrap
msgid "B<5>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:175
msgid "An error was encountered while reading the template file."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:175
#, no-wrap
msgid "B<6>"
msgstr ""

#.  Error 6 doesn't seem to occur in glibc
#. type: Plain text
#: build/C/man3/getdate.3:179
msgid "Memory allocation failed (not enough memory available)."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:179
#, no-wrap
msgid "B<7>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:182
msgid "There is no line in the file that matches the input."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:182
#, no-wrap
msgid "B<8>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:185
msgid "Invalid input specification."
msgstr ""

#. type: SH
#: build/C/man3/getdate.3:185 build/C/man3/strftime.3:323 build/C/man1/time.1:72 build/C/man8/tzselect.8:21
#, no-wrap
msgid "ENVIRONMENT"
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:186
#, no-wrap
msgid "B<DATEMSK>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:189
msgid "File containing format patterns."
msgstr ""

#. type: TP
#: build/C/man3/getdate.3:189
#, no-wrap
msgid "B<TZ>, B<LC_TIME>"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:193
msgid "Variables used by B<strptime>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:209
msgid ""
"The POSIX.1-2001 specification for B<strptime>(3)  contains conversion "
"specifications using the B<%E> or B<%O> modifier, while such specifications "
"are not given for B<getdate>().  In glibc, B<getdate>()  is implemented "
"using B<strptime>(3), so that precisely the same conversions are supported "
"by both."
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:217
msgid ""
"The program below calls B<getdate>()  for each of its command-line "
"arguments, and for each call displays the values in the fields of the "
"returned I<tm> structure.  The following shell session demonstrates the "
"operation of the program:"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:258
#, no-wrap
msgid ""
"$B< TFILE=$PWD/tfile>\n"
"$B< echo \\(aq%A\\(aq E<gt> $TFILE >      # Full weekday name\n"
"$B< echo \\(aq%T\\(aq E<gt>E<gt> $TFILE>      # ISO date (YYYY-MM-DD)\n"
"$B< echo \\(aq%F\\(aq E<gt>E<gt> $TFILE>      # Time (HH:MM:SS)\n"
"$B< date>\n"
"$B< export DATEMSK=$TFILE>\n"
"$B< ./a.out Tuesday \\(aq2009-12-28\\(aq \\(aq12:22:33\\(aq>\n"
"Sun Sep  7 06:03:36 CEST 2008\n"
"Call 1 (\"Tuesday\") succeeded:\n"
"    tm_sec   = 36\n"
"    tm_min   = 3\n"
"    tm_hour  = 6\n"
"    tm_mday  = 9\n"
"    tm_mon   = 8\n"
"    tm_year  = 108\n"
"    tm_wday  = 2\n"
"    tm_yday  = 252\n"
"    tm_isdst = 1\n"
"Call 2 (\"2009-12-28\") succeeded:\n"
"    tm_sec   = 36\n"
"    tm_min   = 3\n"
"    tm_hour  = 6\n"
"    tm_mday  = 28\n"
"    tm_mon   = 11\n"
"    tm_year  = 109\n"
"    tm_wday  = 1\n"
"    tm_yday  = 361\n"
"    tm_isdst = 0\n"
"Call 3 (\"12:22:33\") succeeded:\n"
"    tm_sec   = 33\n"
"    tm_min   = 22\n"
"    tm_hour  = 12\n"
"    tm_mday  = 7\n"
"    tm_mon   = 8\n"
"    tm_year  = 108\n"
"    tm_wday  = 0\n"
"    tm_yday  = 250\n"
"    tm_isdst = 1\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:267
#, no-wrap
msgid ""
"#define _GNU_SOURCE 500\n"
"#include E<lt>time.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:273
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    struct tm *tmp;\n"
"    int j;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:276
#, no-wrap
msgid ""
"    for (j = 1; j E<lt> argc; j++) {\n"
"        tmp = getdate(argv[j]);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:282
#, no-wrap
msgid ""
"        if (tmp == NULL) {\n"
"            printf(\"Call %d failed; getdate_err = %d\\en\",\n"
"                   j, getdate_err);\n"
"            continue;\n"
"        }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:294
#, no-wrap
msgid ""
"        printf(\"Call %d (\\e\"%s\\e\") succeeded:\\en\", j, argv[j]);\n"
"        printf(\"    tm_sec   = %d\\en\", tmp-E<gt>tm_sec);\n"
"        printf(\"    tm_min   = %d\\en\", tmp-E<gt>tm_min);\n"
"        printf(\"    tm_hour  = %d\\en\", tmp-E<gt>tm_hour);\n"
"        printf(\"    tm_mday  = %d\\en\", tmp-E<gt>tm_mday);\n"
"        printf(\"    tm_mon   = %d\\en\", tmp-E<gt>tm_mon);\n"
"        printf(\"    tm_year  = %d\\en\", tmp-E<gt>tm_year);\n"
"        printf(\"    tm_wday  = %d\\en\", tmp-E<gt>tm_wday);\n"
"        printf(\"    tm_yday  = %d\\en\", tmp-E<gt>tm_yday);\n"
"        printf(\"    tm_isdst = %d\\en\", tmp-E<gt>tm_isdst);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:297
#, no-wrap
msgid ""
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getdate.3:304
msgid "B<time>(2), B<localtime>(3), B<setlocale>(3), B<strftime>(3), B<strptime>(3)"
msgstr ""

#. type: TH
#: build/C/man2/gettimeofday.2:40
#, no-wrap
msgid "GETTIMEOFDAY"
msgstr ""

#. type: TH
#: build/C/man2/gettimeofday.2:40
#, no-wrap
msgid "2012-04-26"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:43
msgid "gettimeofday, settimeofday - get / set time"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:48
#, no-wrap
msgid "B<int gettimeofday(struct timeval *>I<tv>B<, struct timezone *>I<tz>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:51
#, no-wrap
msgid ""
"B<int settimeofday(const struct timeval *>I<tv>B<, const struct timezone "
"*>I<tz>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:60
msgid "B<settimeofday>(): _BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:72
msgid ""
"The functions B<gettimeofday>()  and B<settimeofday>()  can get and set the "
"time as well as a timezone.  The I<tv> argument is a I<struct timeval> (as "
"specified in I<E<lt>sys/time.hE<gt>>):"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:88
msgid ""
"and gives the number of seconds and microseconds since the Epoch (see "
"B<time>(2)).  The I<tz> argument is a I<struct timezone>:"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:95
#, no-wrap
msgid ""
"struct timezone {\n"
"    int tz_minuteswest;     /* minutes west of Greenwich */\n"
"    int tz_dsttime;         /* type of DST correction */\n"
"};\n"
msgstr ""

#.  The following is covered under EPERM below:
#.  .PP
#.  Only the superuser may use
#.  .BR settimeofday ().
#. type: Plain text
#: build/C/man2/gettimeofday.2:110
msgid ""
"If either I<tv> or I<tz> is NULL, the corresponding structure is not set or "
"returned.  (However, compilation warnings will result if I<tv> is NULL.)"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:117
msgid ""
"The use of the I<timezone> structure is obsolete; the I<tz> argument should "
"normally be specified as NULL.  (See NOTES below.)"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:136
msgid ""
"Under Linux there are some peculiar \"warp clock\" semantics associated with "
"the B<settimeofday>()  system call if on the very first call (after booting)  "
"that has a non-NULL I<tz> argument, the I<tv> argument is NULL and the "
"I<tz_minuteswest> field is nonzero.  (The I<tz_dsttime> field should be zero "
"for this case.)  In such a case it is assumed that the CMOS clock is on "
"local time, and that it has to be incremented by this amount to get UTC "
"system time.  No doubt it is a bad idea to use this feature."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:143
msgid ""
"B<gettimeofday>()  and B<settimeofday>()  return 0 for success, or -1 for "
"failure (in which case I<errno> is set appropriately)."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:151
msgid "One of I<tv> or I<tz> pointed outside the accessible address space."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:154
msgid "Timezone (or something else) is invalid."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:161
msgid ""
"The calling process has insufficient privilege to call B<settimeofday>(); "
"under Linux the B<CAP_SYS_TIME> capability is required."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:172
msgid ""
"SVr4, 4.3BSD.  POSIX.1-2001 describes B<gettimeofday>()  but not "
"B<settimeofday>().  POSIX.1-2008 marks B<gettimeofday>()  as obsolete, "
"recommending the use of B<clock_gettime>(2)  instead."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:180
msgid ""
"The time returned by B<gettimeofday>(2)  I<is> affected by discontinuous "
"jumps in the system time (e.g., if the system administrator manually changes "
"the system time).  If you need a monotonically increasing clock, see "
"B<clock_gettime>(2)."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:185
msgid ""
"Macros for operating on I<timeval> structures are described in "
"B<timeradd>(3)."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:190
msgid "Traditionally, the fields of I<struct timeval> were of type I<long>."
msgstr ""

#.  it has not
#.  been and will not be supported by libc or glibc.
#.  Each and every occurrence of this field in the kernel source
#.  (other than the declaration) is a bug.
#. type: Plain text
#: build/C/man2/gettimeofday.2:200
msgid ""
"The I<tz_dsttime> field has never been used under Linux.  Thus, the "
"following is purely of historic interest."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:210
msgid ""
"On old systems, the field I<tz_dsttime> contains a symbolic constant (values "
"are given below)  that indicates in which part of the year Daylight Saving "
"Time is in force.  (Note: this value is constant throughout the year: it "
"does not indicate that DST is in force, it just selects an algorithm.)  The "
"daylight saving time algorithms defined are as follows:"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:214
#, no-wrap
msgid "B<DST_NONE>     /* not on DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:216
#, no-wrap
msgid "B<DST_USA>      /* USA style DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:218
#, no-wrap
msgid "B<DST_AUST>     /* Australian style DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:220
#, no-wrap
msgid "B<DST_WET>      /* Western European DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:222
#, no-wrap
msgid "B<DST_MET>      /* Middle European DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:224
#, no-wrap
msgid "B<DST_EET>      /* Eastern European DST */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:226
#, no-wrap
msgid "B<DST_CAN>      /* Canada */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:228
#, no-wrap
msgid "B<DST_GB>       /* Great Britain and Eire */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:230
#, no-wrap
msgid "B<DST_RUM>      /* Romania */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:232
#, no-wrap
msgid "B<DST_TUR>      /* Turkey */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:234
#, no-wrap
msgid "B<DST_AUSTALT>  /* Australian style with shift in 1986 */\n"
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:244
msgid ""
"Of course it turned out that the period in which Daylight Saving Time is in "
"force cannot be given by a simple algorithm, one per country; indeed, this "
"period is determined by unpredictable political decisions.  So this method "
"of representing timezones has been abandoned."
msgstr ""

#. type: Plain text
#: build/C/man2/gettimeofday.2:254
msgid ""
"B<date>(1), B<adjtimex>(2), B<clock_gettime>(2), B<time>(2), B<ctime>(3), "
"B<ftime>(3), B<timeradd>(3), B<capabilities>(7), B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man2/nanosleep.2:35
#, no-wrap
msgid "NANOSLEEP"
msgstr ""

#. type: TH
#: build/C/man2/nanosleep.2:35
#, no-wrap
msgid "2009-01-19"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:38
msgid "nanosleep - high-resolution sleep"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:42
msgid ""
"B<int nanosleep(const struct timespec *>I<req>B<, struct timespec "
"*>I<rem>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:50
msgid "B<nanosleep>(): _POSIX_C_SOURCE\\ E<gt>=\\ 199309L"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:58
msgid ""
"B<nanosleep>()  suspends the execution of the calling thread until either at "
"least the time specified in I<*req> has elapsed, or the delivery of a signal "
"that triggers the invocation of a handler in the calling thread or that "
"terminates the process."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:73
msgid ""
"If the call is interrupted by a signal handler, B<nanosleep>()  returns -1, "
"sets I<errno> to B<EINTR>, and writes the remaining time into the structure "
"pointed to by I<rem> unless I<rem> is NULL.  The value of I<*rem> can then "
"be used to call B<nanosleep>()  again and complete the specified pause (but "
"see NOTES)."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:78
msgid ""
"The structure I<timespec> is used to specify intervals of time with "
"nanosecond precision.  It is defined as follows:"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:85 build/C/man2/utimensat.2:108
#, no-wrap
msgid ""
"struct timespec {\n"
"    time_t tv_sec;        /* seconds */\n"
"    long   tv_nsec;       /* nanoseconds */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:89
msgid "The value of the nanoseconds field must be in the range 0 to 999999999."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:101
msgid ""
"Compared to B<sleep>(3)  and B<usleep>(3), B<nanosleep>()  has the following "
"advantages: it provides a higher resolution for specifying the sleep "
"interval; POSIX.1 explicitly specifies that it does not interact with "
"signals; and it makes the task of resuming a sleep that has been interrupted "
"by a signal handler easier."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:109
msgid ""
"On successfully sleeping for the requested interval, B<nanosleep>()  returns "
"0.  If the call is interrupted by a signal handler or encounters an error, "
"then it returns -1, with I<errno> set to indicate the error."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:113
msgid "Problem with copying information from user space."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:121
msgid ""
"The pause has been interrupted by a signal that was delivered to the "
"thread.  The remaining sleep time has been written into I<*rem> so that the "
"thread can easily call B<nanosleep>()  again and continue with the pause."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:138
msgid ""
"If the interval specified in I<req> is not an exact multiple of the "
"granularity underlying clock (see B<time>(7)), then the interval will be "
"rounded up to the next multiple.  Furthermore, after the sleep completes, "
"there may still be a delay before the CPU becomes free to once again execute "
"the calling thread."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:148
msgid ""
"The fact that B<nanosleep>()  sleeps for a relative interval can be "
"problematic if the call is repeatedly restarted after being interrupted by "
"signals, since the time between the interruptions and restarts of the call "
"will lead to drift in the time when the sleep finally completes.  This "
"problem can be avoided by using B<clock_nanosleep>(2)  with an absolute time "
"value."
msgstr ""

#.  See also http://thread.gmane.org/gmane.linux.kernel/696854/
#.  Subject: nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?
#.  Date: 2008-06-22 07:35:41 GMT
#. type: Plain text
#: build/C/man2/nanosleep.2:166
msgid ""
"POSIX.1 specifies that B<nanosleep>()  should measure time against the "
"B<CLOCK_REALTIME> clock.  However, Linux measures the time using the "
"B<CLOCK_MONOTONIC> clock.  This probably does not matter, since the POSIX.1 "
"specification for B<clock_settime>(2)  says that discontinuous changes in "
"B<CLOCK_REALTIME> should not affect B<nanosleep>():"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:179
msgid ""
"Setting the value of the B<CLOCK_REALTIME> clock via B<clock_settime>(2)  "
"shall have no effect on threads that are blocked waiting for a relative time "
"service based upon this clock, including the B<nanosleep>()  function; ...  "
"Consequently, these time services shall expire when the requested relative "
"interval elapses, independently of the new or old value of the clock."
msgstr ""

#. type: SS
#: build/C/man2/nanosleep.2:180
#, no-wrap
msgid "Old behavior"
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:193
msgid ""
"In order to support applications requiring much more precise pauses (e.g., "
"in order to control some time-critical hardware), B<nanosleep>()  would "
"handle pauses of up to 2\\ ms by busy waiting with microsecond precision "
"when called from a thread scheduled under a real-time policy like "
"B<SCHED_FIFO> or B<SCHED_RR>.  This special extension was removed in kernel "
"2.5.39, hence is still present in current 2.4 kernels, but not in 2.6 "
"kernels."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:206
msgid ""
"In Linux 2.4, if B<nanosleep>()  is stopped by a signal (e.g., B<SIGTSTP>), "
"then the call fails with the error B<EINTR> after the thread is resumed by a "
"B<SIGCONT> signal.  If the system call is subsequently restarted, then the "
"time that the thread spent in the stopped state is I<not> counted against "
"the sleep interval."
msgstr ""

#. type: Plain text
#: build/C/man2/nanosleep.2:213
msgid ""
"B<clock_nanosleep>(2), B<sched_setscheduler>(2), B<timer_create>(2), "
"B<sleep>(3), B<usleep>(3), B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man4/rtc.4:29
#, no-wrap
msgid "RTC"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:32
msgid "rtc - real-time clock"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:34
msgid "#include E<lt>linux/rtc.hE<gt>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:36
msgid "B<int ioctl(>I<fd>B<, RTC_>I<request>B<, >I<param>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:38
msgid "This is the interface to drivers for real-time clocks (RTCs)."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:45
msgid ""
"Most computers have one or more hardware clocks which record the current "
"\"wall clock\" time.  These are called \"Real Time Clocks\" (RTCs).  One of "
"these usually has battery backup power so that it tracks the time even while "
"the computer is turned off.  RTCs often provide alarms and other interrupts."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:50
msgid ""
"All i386 PCs, and ACPI-based systems, have an RTC that is compatible with "
"the Motorola MC146818 chip on the original PC/AT.  Today such an RTC is "
"usually integrated into the mainboard's chipset (south bridge), and uses a "
"replaceable coin-sized backup battery."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:54
msgid ""
"Non-PC systems, such as embedded systems built around system-on-chip "
"processors, use other implementations.  They usually won't offer the same "
"functionality as the RTC from a PC/AT."
msgstr ""

#. type: SS
#: build/C/man4/rtc.4:54
#, no-wrap
msgid "RTC vs System Clock"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:66
msgid ""
"RTCs should not be confused with the system clock, which is a software clock "
"maintained by the kernel and used to implement B<gettimeofday>(2)  and "
"B<time>(2), as well as setting timestamps on files, etc.  The system clock "
"reports seconds and microseconds since a start point, defined to be the "
"POSIX Epoch: 1970-01-01 00:00:00 +0000 (UTC).  (One common implementation "
"counts timer interrupts, once per \"jiffy\", at a frequency of 100, 250, or "
"1000 Hz.)  That is, it is supposed to report wall clock time, which RTCs "
"also do."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:76
msgid ""
"A key difference between an RTC and the system clock is that RTCs run even "
"when the system is in a low power state (including \"off\"), and the system "
"clock can't.  Until it is initialized, the system clock can only report time "
"since system boot ... not since the POSIX Epoch.  So at boot time, and after "
"resuming from a system low power state, the system clock will often be set "
"to the current wall clock time using an RTC.  Systems without an RTC need to "
"set the system clock using another clock, maybe across the network or by "
"entering that data manually."
msgstr ""

#. type: SS
#: build/C/man4/rtc.4:76
#, no-wrap
msgid "RTC functionality"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:80
msgid ""
"RTCs can be read and written with B<hwclock>(8), or directly with the ioctl "
"requests listed below."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:83
msgid "Besides tracking the date and time, many RTCs can also generate interrupts"
msgstr ""

#. type: IP
#: build/C/man4/rtc.4:83 build/C/man4/rtc.4:85 build/C/man4/rtc.4:88 build/C/man2/utimensat.2:246 build/C/man2/utimensat.2:277 build/C/man2/utimensat.2:384 build/C/man2/utimensat.2:390 build/C/man2/utimensat.2:468 build/C/man2/utimensat.2:483 build/C/man2/utimensat.2:585
#, no-wrap
msgid "*"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:85
msgid "on every clock update (i.e., once per second);"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:88
msgid ""
"at periodic intervals with a frequency that can be set to any power-of-2 "
"multiple in the range 2 Hz to 8192 Hz;"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:90
msgid "on reaching a previously specified alarm time."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:99
msgid ""
"Each of those interrupt sources can be enabled or disabled separately.  On "
"many systems, the alarm interrupt can be configured as a system wakeup "
"event, which can resume the system from a low power state such as "
"Suspend-to-RAM (STR, called S3 in ACPI systems), Hibernation (called S4 in "
"ACPI systems), or even \"off\" (called S5 in ACPI systems).  On some "
"systems, the battery backed RTC can't issue interrupts, but another one can."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:119
msgid ""
"The I</dev/rtc> (or I</dev/rtc0>, I</dev/rtc1>, etc.)  device can be opened "
"only once (until it is closed) and it is read-only.  On B<read>(2)  and "
"B<select>(2)  the calling process is blocked until the next interrupt from "
"that RTC is received.  Following the interrupt, the process can read a long "
"integer, of which the least significant byte contains a bit mask encoding "
"the types of interrupt that occurred, while the remaining 3 bytes contain "
"the number of interrupts since the last B<read>(2)."
msgstr ""

#. type: SS
#: build/C/man4/rtc.4:119
#, no-wrap
msgid "ioctl(2) interface"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:123
msgid ""
"The following B<ioctl>(2)  requests are defined on file descriptors "
"connected to RTC devices:"
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:123
#, no-wrap
msgid "B<RTC_RD_TIME>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:126
msgid "Returns this RTC's time in the following structure:"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:140
#, no-wrap
msgid ""
"struct rtc_time {\n"
"    int tm_sec;\n"
"    int tm_min;\n"
"    int tm_hour;\n"
"    int tm_mday;\n"
"    int tm_mon;\n"
"    int tm_year;\n"
"    int tm_wday;     /* unused */\n"
"    int tm_yday;     /* unused */\n"
"    int tm_isdst;    /* unused */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:150
msgid ""
"The fields in this structure have the same meaning and ranges as for the "
"I<tm> structure described in B<gmtime>(3).  A pointer to this structure "
"should be passed as the third B<ioctl>(2)  argument."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:150
#, no-wrap
msgid "B<RTC_SET_TIME>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:161
msgid ""
"Sets this RTC's time to the time specified by the I<rtc_time> structure "
"pointed to by the third B<ioctl>(2)  argument.  To set the RTC's time the "
"process must be privileged (i.e., have the B<CAP_SYS_TIME> capability)."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:161
#, no-wrap
msgid "B<RTC_ALM_READ>, B<RTC_ALM_SET>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:178
msgid ""
"Read and set the alarm time, for RTCs that support alarms.  The alarm "
"interrupt must be separately enabled or disabled using the B<RTC_AIE_ON>, "
"B<RTC_AIE_OFF> requests.  The third B<ioctl>(2)  argument is a pointer to an "
"I<rtc_time> structure.  Only the I<tm_sec>, I<tm_min>, and I<tm_hour> fields "
"of this structure are used."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:178
#, no-wrap
msgid "B<RTC_IRQP_READ>, B<RTC_IRQP_SET>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:200
msgid ""
"Read and set the frequency for periodic interrupts, for RTCs that support "
"periodic interrupts.  The periodic interrupt must be separately enabled or "
"disabled using the B<RTC_PIE_ON>, B<RTC_PIE_OFF> requests.  The third "
"B<ioctl>(2)  argument is an I<unsigned long\\ *> or an I<unsigned long>, "
"respectively.  The value is the frequency in interrupts per second.  The set "
"of allowable frequencies is the multiples of two in the range 2 to 8192.  "
"Only a privileged process (i.e., one having the B<CAP_SYS_RESOURCE> "
"capability) can set frequencies above the value specified in "
"I</proc/sys/dev/rtc/max-user-freq>.  (This file contains the value 64 by "
"default.)"
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:200
#, no-wrap
msgid "B<RTC_AIE_ON>, B<RTC_AIE_OFF>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:206
msgid ""
"Enable or disable the alarm interrupt, for RTCs that support alarms.  The "
"third B<ioctl>(2)  argument is ignored."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:206
#, no-wrap
msgid "B<RTC_UIE_ON>, B<RTC_UIE_OFF>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:213
msgid ""
"Enable or disable the interrupt on every clock update, for RTCs that support "
"this once-per-second interrupt.  The third B<ioctl>(2)  argument is ignored."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:213
#, no-wrap
msgid "B<RTC_PIE_ON>, B<RTC_PIE_OFF>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:225
msgid ""
"Enable or disable the periodic interrupt, for RTCs that support these "
"periodic interrupts.  The third B<ioctl>(2)  argument is ignored.  Only a "
"privileged process (i.e., one having the B<CAP_SYS_RESOURCE> capability) can "
"enable the periodic interrupt if the frequency is currently set above the "
"value specified in I</proc/sys/dev/rtc/max-user-freq>."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:225
#, no-wrap
msgid "B<RTC_EPOCH_READ>, B<RTC_EPOCH_SET>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:248
msgid ""
"Many RTCs encode the year in an 8-bit register which is either interpreted "
"as an 8-bit binary number or as a BCD number.  In both cases, the number is "
"interpreted relative to this RTC's Epoch.  The RTC's Epoch is initialized to "
"1900 on most systems but on Alpha and MIPS it might also be initialized to "
"1952, 1980, or 2000, depending on the value of an RTC register for the "
"year.  With some RTCs, these operations can be used to read or to set the "
"RTC's Epoch, respectively.  The third B<ioctl>(2)  argument is a I<unsigned "
"long\\ *> or a I<unsigned long>, respectively, and the value returned (or "
"assigned) is the Epoch.  To set the RTC's Epoch the process must be "
"privileged (i.e., have the B<CAP_SYS_TIME> capability)."
msgstr ""

#. type: TP
#: build/C/man4/rtc.4:248
#, no-wrap
msgid "B<RTC_WKALM_RD>, B<RTC_WKALM_SET>"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:252
msgid ""
"Some RTCs support a more powerful alarm interface, using these ioctls to "
"read or write the RTC's alarm time (respectively) with this structure:"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:261
#, no-wrap
msgid ""
"struct rtc_wkalrm {\n"
"    unsigned char enabled;\n"
"    unsigned char pending;\n"
"    struct rtc_time time;\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:293
msgid ""
"The I<enabled> flag is used to enable or disable the alarm interrupt, or to "
"read its current status; when using these calls, B<RTC_AIE_ON> and "
"B<RTC_AIE_OFF> are not used.  The I<pending> flag is used by B<RTC_WKALM_RD> "
"to report a pending interrupt (so it's mostly useless on Linux, except when "
"talking to the RTC managed by EFI firmware).  The I<time> field is as used "
"with B<RTC_ALM_READ> and B<RTC_ALM_SET> except that the I<tm_mday>, "
"I<tm_mon>, and I<tm_year> fields are also valid.  A pointer to this "
"structure should be passed as the third B<ioctl>(2)  argument."
msgstr ""

#. type: SH
#: build/C/man4/rtc.4:293 build/C/man8/tzselect.8:33 build/C/man3/tzset.3:190 build/C/man8/zic.8:406
#, no-wrap
msgid "FILES"
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:298
msgid ""
"I</dev/rtc>, I</dev/rtc0>, I</dev/rtc1>, etc: RTC special character device "
"files."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:301
msgid "I</proc/driver/rtc>: status of the (first) RTC."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:308
msgid ""
"When the kernel's system time is synchronized with an external reference "
"using B<adjtimex>(2)  it will update a designated RTC periodically every 11 "
"minutes.  To do so, the kernel has to briefly turn off periodic interrupts; "
"this might affect programs using that RTC."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:311
msgid ""
"An RTC's Epoch has nothing to do with the POSIX Epoch which is only used for "
"the system clock."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:315
msgid ""
"If the year according to the RTC's Epoch and the year register is less than "
"1970 it is assumed to be 100 years later, that is, between 2000 and 2069."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:322
msgid ""
"Some RTCs support \"wildcard\" values in alarm fields, to support scenarios "
"like periodic alarms at fifteen minutes after every hour, or on the first "
"day of each month.  Such usage is nonportable; portable user space code only "
"expects a single alarm interrupt, and will either disable or reinitialize "
"the alarm after receiving it."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:330
msgid ""
"Some RTCs support periodic interrupts with periods that are multiples of a "
"second rather than fractions of a second; multiple alarms; programmable "
"output clock signals; nonvolatile memory; and other hardware capabilities "
"that are not currently exposed by this API."
msgstr ""

#. type: Plain text
#: build/C/man4/rtc.4:341
msgid ""
"B<date>(1), B<adjtimex>(2), B<gettimeofday>(2), B<settimeofday>(2), "
"B<stime>(2), B<time>(2), B<gmtime>(3), B<time>(7), B<hwclock>(8), "
"/usr/src/linux/Documentation/rtc.txt"
msgstr ""

#. type: TH
#: build/C/man2/stime.2:30
#, no-wrap
msgid "STIME"
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:33
msgid "stime - set time"
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:37
msgid "B<int stime(time_t *>I<t>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:45
msgid "B<stime>(): _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:53
msgid ""
"B<stime>()  sets the system's idea of the time and date.  The time, pointed "
"to by I<t>, is measured in seconds since the Epoch, 1970-01-01 00:00:00 "
"+0000 (UTC).  B<stime>()  may only be executed by the superuser."
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:62
msgid "Error in getting information from user space."
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:68
msgid ""
"The calling process has insufficient privilege.  Under Linux the "
"B<CAP_SYS_TIME> privilege is required."
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:70
msgid "SVr4."
msgstr ""

#. type: Plain text
#: build/C/man2/stime.2:74
msgid "B<date>(1), B<settimeofday>(2), B<capabilities>(7)"
msgstr ""

#. type: TH
#: build/C/man3/strftime.3:35
#, no-wrap
msgid "STRFTIME"
msgstr ""

#. type: TH
#: build/C/man3/strftime.3:35
#, no-wrap
msgid "2010-01-17"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:38
msgid "strftime - format date and time"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:44
#, no-wrap
msgid ""
"B<size_t strftime(char *>I<s>B<, size_t >I<max>B<, const char "
"*>I<format>B<,>\n"
"B<                const struct tm *>I<tm>B<);>\n"
msgstr ""

#.  FIXME POSIX says: Local timezone information is used as though
#.  strftime() called tzset().  But this doesn't appear to be the case
#. type: Plain text
#: build/C/man3/strftime.3:53
msgid ""
"The B<strftime>()  function formats the broken-down time I<tm> according to "
"the format specification I<format> and places the result in the character "
"array I<s> of size I<max>."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:62
msgid ""
"The format specification is a null-terminated string and may contain special "
"character sequences called I<conversion specifications>, each of which is "
"introduced by a \\(aq%\\(aq character and terminated by some other character "
"known as a I<conversion specifier character>.  All other character sequences "
"are I<ordinary character sequences>."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:66
msgid ""
"The characters of ordinary character sequences (including the null byte)  "
"are copied verbatim from I<format> to I<s>. However, the characters of "
"conversion specifications are replaced as follows:"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:66
#, no-wrap
msgid "B<%a>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:69
msgid "The abbreviated weekday name according to the current locale."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:69
#, no-wrap
msgid "B<%A>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:72
msgid "The full weekday name according to the current locale."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:72
#, no-wrap
msgid "B<%b>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:75
msgid "The abbreviated month name according to the current locale."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:75
#, no-wrap
msgid "B<%B>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:78
msgid "The full month name according to the current locale."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:78 build/C/man3/strptime.3:96 build/C/man1/time.1:191
#, no-wrap
msgid "B<%c>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:81
msgid "The preferred date and time representation for the current locale."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:81 build/C/man3/strptime.3:99 build/C/man1/time.1:216
#, no-wrap
msgid "B<%C>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:84
msgid "The century number (year/100) as a 2-digit integer. (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:84
#, no-wrap
msgid "B<%d>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:87
msgid "The day of the month as a decimal number (range 01 to 31)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:87 build/C/man3/strptime.3:105 build/C/man1/time.1:164
#, no-wrap
msgid "B<%D>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:97
msgid ""
"Equivalent to B<%m/%d/%y>.  (Yecch\\(emfor Americans only.  Americans should "
"note that in other countries B<%d/%m/%y> is rather common.  This means that "
"in international context this format is ambiguous and should not be used.) "
"(SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:97 build/C/man1/time.1:140
#, no-wrap
msgid "B<%e>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:103
msgid ""
"Like B<%d>, the day of the month as a decimal number, but a leading zero is "
"replaced by a space. (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:103 build/C/man1/time.1:137
#, no-wrap
msgid "B<%E>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:106 build/C/man3/strftime.3:165
msgid "Modifier: use alternative format, see below. (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:106 build/C/man3/strptime.3:332 build/C/man1/time.1:177
#, no-wrap
msgid "B<%F>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:111
msgid "Equivalent to B<%Y-%m-%d> (the ISO\\ 8601 date format). (C99)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:111 build/C/man3/strptime.3:339
#, no-wrap
msgid "B<%G>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:120
msgid ""
"The ISO\\ 8601 week-based year (see NOTES) with century as a decimal "
"number.  The 4-digit year corresponding to the ISO week number (see B<%V>).  "
"This has the same format and value as B<%Y>, except that if the ISO week "
"number belongs to the previous or next year, that year is used instead. (TZ)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:120 build/C/man3/strptime.3:335
#, no-wrap
msgid "B<%g>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:125
msgid "Like B<%G>, but without century, that is, with a 2-digit year (00-99). (TZ)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:125
#, no-wrap
msgid "B<%h>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:130
msgid "Equivalent to B<%b>.  (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:130 build/C/man3/strptime.3:115
#, no-wrap
msgid "B<%H>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:133
msgid "The hour as a decimal number using a 24-hour clock (range 00 to 23)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:133 build/C/man3/strptime.3:118 build/C/man1/time.1:201
#, no-wrap
msgid "B<%I>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:136
msgid "The hour as a decimal number using a 12-hour clock (range 01 to 12)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:136 build/C/man3/strptime.3:121
#, no-wrap
msgid "B<%j>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:139
msgid "The day of the year as a decimal number (range 001 to 366)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:139 build/C/man1/time.1:213
#, no-wrap
msgid "B<%k>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:146
msgid ""
"The hour (24-hour clock) as a decimal number (range 0 to 23); single digits "
"are preceded by a blank.  (See also B<%H>.)  (TZ)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:146
#, no-wrap
msgid "B<%l>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:153
msgid ""
"The hour (12-hour clock) as a decimal number (range 1 to 12); single digits "
"are preceded by a blank.  (See also B<%I>.)  (TZ)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:153 build/C/man3/strptime.3:124
#, no-wrap
msgid "B<%m>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:156
msgid "The month as a decimal number (range 01 to 12)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:156 build/C/man3/strptime.3:127 build/C/man1/time.1:154
#, no-wrap
msgid "B<%M>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:159
msgid "The minute as a decimal number (range 00 to 59)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:159 build/C/man3/strptime.3:130
#, no-wrap
msgid "B<%n>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:162
msgid "A newline character. (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:162 build/C/man1/time.1:204
#, no-wrap
msgid "B<%O>"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:165 build/C/man3/strptime.3:133 build/C/man1/time.1:167
#, no-wrap
msgid "B<%p>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:170
msgid ""
"Either \"AM\" or \"PM\" according to the given time value, or the "
"corresponding strings for the current locale.  Noon is treated as \"PM\" and "
"midnight as \"AM\"."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:170 build/C/man1/time.1:149
#, no-wrap
msgid "B<%P>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:176
msgid ""
"Like B<%p> but in lowercase: \"am\" or \"pm\" or a corresponding string for "
"the current locale. (GNU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:176 build/C/man3/strptime.3:137 build/C/man1/time.1:207
#, no-wrap
msgid "B<%r>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:182
msgid ""
"The time in a.m. or p.m. notation.  In the POSIX locale this is equivalent "
"to B<%I:%M:%S %p>.  (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:182 build/C/man3/strptime.3:146 build/C/man1/time.1:181
#, no-wrap
msgid "B<%R>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:188
msgid ""
"The time in 24-hour notation (B<%H:%M>). (SU)  For a version including the "
"seconds, see B<%T> below."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:188 build/C/man3/strptime.3:375 build/C/man1/time.1:210
#, no-wrap
msgid "B<%s>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:191
msgid "The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). (TZ)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:191 build/C/man3/strptime.3:150 build/C/man1/time.1:143
#, no-wrap
msgid "B<%S>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:195
msgid ""
"The second as a decimal number (range 00 to 60).  (The range is up to 60 to "
"allow for occasional leap seconds.)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:195 build/C/man3/strptime.3:154 build/C/man1/time.1:157
#, no-wrap
msgid "B<%t>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:198
msgid "A tab character. (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:198 build/C/man3/strptime.3:157
#, no-wrap
msgid "B<%T>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:201
msgid "The time in 24-hour notation (B<%H:%M:%S>). (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:201 build/C/man3/strptime.3:343
#, no-wrap
msgid "B<%u>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:207
msgid ""
"The day of the week as a decimal, range 1 to 7, Monday being 1.  See also "
"B<%w>.  (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:207 build/C/man3/strptime.3:161 build/C/man1/time.1:146
#, no-wrap
msgid "B<%U>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:216
msgid ""
"The week number of the current year as a decimal number, range 00 to 53, "
"starting with the first Sunday as the first day of week 01.  See also B<%V> "
"and B<%W>."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:216 build/C/man3/strptime.3:346
#, no-wrap
msgid "B<%V>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:226
msgid ""
"The ISO\\ 8601 week number (see NOTES) of the current year as a decimal "
"number, range 01 to 53, where week 1 is the first week that has at least 4 "
"days in the new year.  See also B<%U> and B<%W>.  (SU)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:226 build/C/man3/strptime.3:165 build/C/man1/time.1:195
#, no-wrap
msgid "B<%w>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:231
msgid ""
"The day of the week as a decimal, range 0 to 6, Sunday being 0.  See also "
"B<%u>."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:231 build/C/man3/strptime.3:168 build/C/man1/time.1:188
#, no-wrap
msgid "B<%W>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:235
msgid ""
"The week number of the current year as a decimal number, range 00 to 53, "
"starting with the first Monday as the first day of week 01."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:235 build/C/man3/strptime.3:172 build/C/man1/time.1:219
#, no-wrap
msgid "B<%x>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:238
msgid "The preferred date representation for the current locale without the time."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:238 build/C/man3/strptime.3:175 build/C/man1/time.1:170
#, no-wrap
msgid "B<%X>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:241
msgid "The preferred time representation for the current locale without the date."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:241 build/C/man3/strptime.3:178
#, no-wrap
msgid "B<%y>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:244
msgid "The year as a decimal number without a century (range 00 to 99)."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:244 build/C/man3/strptime.3:184
#, no-wrap
msgid "B<%Y>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:247
msgid "The year as a decimal number including the century."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:247 build/C/man3/strptime.3:353
#, no-wrap
msgid "B<%z>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:254
msgid ""
"The I<+hhmm> or I<-hhmm> numeric timezone (that is, the hour and minute "
"offset from UTC). (SU)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:257
msgid "The timezone or name or abbreviation."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:257
#, no-wrap
msgid "B<%+>"
msgstr ""

#.  Nov 05 -- Not in Linux/glibc, but is in some BSDs (according to
#.  their man pages)
#. type: Plain text
#: build/C/man3/strftime.3:265
msgid "The date and time in B<date>(1)  format. (TZ)  (Not supported in glibc2.)"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:265 build/C/man3/strptime.3:83
#, no-wrap
msgid "B<%%>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:268
msgid "A literal \\(aq%\\(aq character."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:304
msgid ""
"Some conversion specifications can be modified by preceding the conversion "
"specifier character by the B<E> or B<O> I<modifier> to indicate that an "
"alternative format should be used.  If the alternative format or "
"specification does not exist for the current locale, the behavior will be as "
"if the unmodified conversion specification were used. (SU)  The Single UNIX "
"Specification mentions B<%Ec>, B<%EC>, B<%Ex>, B<%EX>, B<%Ey>, B<%EY>, "
"B<%Od>, B<%Oe>, B<%OH>, B<%OI>, B<%Om>, B<%OM>, B<%OS>, B<%Ou>, B<%OU>, "
"B<%OV>, B<%Ow>, B<%OW>, B<%Oy>, where the effect of the B<O> modifier is to "
"use alternative numeric symbols (say, roman numerals), and that of the E "
"modifier is to use a locale-dependent alternative representation."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:308
msgid ""
"The broken-down time structure I<tm> is defined in I<E<lt>time.hE<gt>>.  See "
"also B<ctime>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:318
msgid ""
"The B<strftime>()  function returns the number of characters placed in the "
"array I<s>, not including the terminating null byte, provided the string, "
"including the terminating null byte, fits.  Otherwise, it returns 0, and the "
"contents of the array is undefined.  (This behavior applies since at least "
"libc 4.4.4; very old versions of libc, such as libc 4.4.1, would return "
"I<max> if the array was too small.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:323
msgid ""
"Note that the return value 0 does not necessarily indicate an error; for "
"example, in many locales B<%p> yields an empty string."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:329
msgid "The environment variables B<TZ> and B<LC_TIME> are used."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:346
msgid ""
"SVr4, C89, C99.  There are strict inclusions between the set of conversions "
"given in ANSI C (unmarked), those given in the Single UNIX Specification "
"(marked SU), those given in Olson's timezone package (marked TZ), and those "
"given in glibc (marked GNU), except that B<%+> is not supported in glibc2.  "
"On the other hand glibc2 has several more extensions.  POSIX.1 only refers "
"to ANSI C; POSIX.2 describes under B<date>(1)  several extensions that could "
"apply to B<strftime>()  as well.  The B<%F> conversion is in C99 and "
"POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:353
msgid ""
"In SUSv2, the B<%S> specifier allowed a range of 00 to 61, to allow for the "
"theoretical possibility of a minute that included a double leap second "
"(there never has been such a minute)."
msgstr ""

#. type: SS
#: build/C/man3/strftime.3:354
#, no-wrap
msgid "ISO 8601 Week Dates"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:376
msgid ""
"B<%G>, B<%g>, and B<%V> yield values calculated from the week-based year "
"defined by the ISO\\ 8601 standard.  In this system, weeks start on a "
"Monday, and are numbered from 01, for the first week, up to 52 or 53, for "
"the last week.  Week 1 is the first week where four or more days fall within "
"the new year (or, synonymously, week 01 is: the first week of the year that "
"contains a Thursday; or, the week that has 4 January in it).  When three of "
"fewer days of the first calendar week of the new year fall within that year, "
"then the ISO 8601 week-based system counts those days as part of week 53 of "
"the preceding year.  For example, 1 January 2010 is a Friday, meaning that "
"just three days of that calendar week fall in 2010.  Thus, the ISO\\ 8601 "
"week-based system considers these days to be part of week 53 (B<%V>) of the "
"year 2009 (B<%G>) ; week 01 of ISO\\ 8601 year 2010 starts on Monday, 4 "
"January 2010."
msgstr ""

#. type: SS
#: build/C/man3/strftime.3:376 build/C/man3/strptime.3:324
#, no-wrap
msgid "Glibc Notes"
msgstr ""

#.  HP-UX and Tru64 also have features like this.
#. type: Plain text
#: build/C/man3/strftime.3:392
msgid ""
"Glibc provides some extensions for conversion specifications.  (These "
"extensions are not specified in POSIX.1-2001, but a few other systems "
"provide similar features.)  Between the \\(aq%\\(aq character and the "
"conversion specifier character, an optional I<flag> and field I<width> may "
"be specified.  (These precede the B<E> or B<O> modifiers, if present.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:394
msgid "The following flag characters are permitted:"
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:394
#, no-wrap
msgid "B<_>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:398
msgid "(underscore)  Pad a numeric result string with spaces."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:398
#, no-wrap
msgid "B<->"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:402
msgid "(dash)  Do not pad a numeric result string."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:402
#, no-wrap
msgid "B<0>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:406
msgid ""
"Pad a numeric result string with zeros even if the conversion specifier "
"character uses space-padding by default."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:406
#, no-wrap
msgid "B<^>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:409
msgid "Convert alphabetic characters in result string to upper case."
msgstr ""

#. type: TP
#: build/C/man3/strftime.3:409
#, no-wrap
msgid "B<#>"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:415
msgid ""
"Swap the case of the result string.  (This flag only works with certain "
"conversion specifier characters, and of these, it is only really useful with "
"B<%Z>.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:419
msgid ""
"An optional decimal width specifier may follow the (possibly absent) flag.  "
"If the natural size of the field is smaller than this width, then the result "
"string is padded (on the left) to the specified width."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:434
msgid ""
"Some buggy versions of B<gcc>(1)  complain about the use of B<%c>: "
"I<warning: `%c' yields only last 2 digits of year in some locales>.  Of "
"course programmers are encouraged to use B<%c>, it gives the preferred date "
"and time representation.  One meets all kinds of strange obfuscations to "
"circumvent this B<gcc>(1)  problem.  A relatively clean one is to add an "
"intermediate function"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:443
#, no-wrap
msgid ""
"size_t\n"
"my_strftime(char *s, size_t max, const char *fmt,\n"
"            const struct tm *tm)\n"
"{\n"
"    return strftime(s, max, fmt, tm);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:450
msgid ""
"Nowadays, B<gcc>(1)  provides the I<-Wno-format-y2k> option to prevent the "
"warning, so that the above workaround is no longer required."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:453
msgid "B<RFC\\ 2822-compliant date format> (with an English locale for %a and %b)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:456
msgid "%a,\\ %d\\ %b\\ %Y\\ %T\\ %z"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:459
msgid "B<RFC\\ 822-compliant date format> (with an English locale for %a and %b)"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:462
msgid "%a,\\ %d\\ %b\\ %y\\ %T\\ %z"
msgstr ""

#. type: SS
#: build/C/man3/strftime.3:462
#, no-wrap
msgid "Example Program"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:465
msgid "The program below can be used to experiment with B<strftime>()."
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:469
msgid ""
"Some examples of the result string produced by the glibc implementation of "
"B<strftime>()  are as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:478
#, no-wrap
msgid ""
"$B< ./a.out \\(aq%m\\(aq>\n"
"Result string is \"11\"\n"
"$B< ./a.out \\(aq%5m\\(aq>\n"
"Result string is \"00011\"\n"
"$B< ./a.out \\(aq%_5m\\(aq>\n"
"Result string is \"   11\"\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:482
msgid "Here's the program source:"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:487
#, no-wrap
msgid ""
"#include E<lt>time.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:494
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    char outstr[200];\n"
"    time_t t;\n"
"    struct tm *tmp;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:501
#, no-wrap
msgid ""
"    t = time(NULL);\n"
"    tmp = localtime(&t);\n"
"    if (tmp == NULL) {\n"
"        perror(\"localtime\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:506
#, no-wrap
msgid ""
"    if (strftime(outstr, sizeof(outstr), argv[1], tmp) == 0) {\n"
"        fprintf(stderr, \"strftime returned 0\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:510
#, no-wrap
msgid ""
"    printf(\"Result string is \\e\"%s\\e\"\\en\", outstr);\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strftime.3:518
msgid ""
"B<date>(1), B<time>(2), B<ctime>(3), B<setlocale>(3), B<sprintf>(3), "
"B<strptime>(3)"
msgstr ""

#. type: TH
#: build/C/man3/strptime.3:29
#, no-wrap
msgid "STRPTIME"
msgstr ""

#. type: TH
#: build/C/man3/strptime.3:29
#, no-wrap
msgid "2009-12-05"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:32
msgid "strptime - convert a string representation of time to a time tm structure"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:34
msgid "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:39
msgid ""
"B<char *strptime(const char *>I<s>B<, const char *>I<format>B<,> B<struct tm "
"*>I<tm>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:68
msgid ""
"The B<strptime>()  function is the converse function to B<strftime>(3)  and "
"converts the character string pointed to by I<s> to values which are stored "
"in the I<tm> structure pointed to by I<tm>, using the format specified by "
"I<format>.  Here I<format> is a character string that consists of field "
"descriptors and text characters, reminiscent of B<scanf>(3).  Each field "
"descriptor consists of a B<%> character followed by another character that "
"specifies the replacement for the field descriptor.  All other characters in "
"the I<format> string must have a matching character in the input string, "
"except for whitespace, which matches zero or more whitespace characters in "
"the input string.  There should be white\\%space or other alphanumeric "
"characters between any two field descriptors."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:77
msgid ""
"The B<strptime>()  function processes the input string from left to right.  "
"Each of the three possible input elements (whitespace, literal, or format) "
"are handled one after the other.  If the input cannot be matched to the "
"format string the function stops.  The remainder of the format and input "
"strings are not processed."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:83
msgid ""
"The supported input field descriptors are listed below.  In case a text "
"string (such as a weekday or month name)  is to be matched, the comparison "
"is case insensitive.  In case a number is to be matched, leading zeros are "
"permitted but not required."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:88
msgid "The B<%> character."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:88
#, no-wrap
msgid "B<%a> or B<%A>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:92
msgid ""
"The weekday name according to the current locale, in abbreviated form or the "
"full name."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:92
#, no-wrap
msgid "B<%b> or B<%B> or B<%h>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:96
msgid ""
"The month name according to the current locale, in abbreviated form or the "
"full name."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:99
msgid "The date and time representation for the current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:102
msgid "The century number (0-99)."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:102
#, no-wrap
msgid "B<%d> or B<%e>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:105
msgid "The day of month (1-31)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:115
msgid ""
"Equivalent to B<%m/%d/%y>.  (This is the American style date, very confusing "
"to non-Americans, especially since B<%d/%m/%y> is widely used in Europe.  "
"The ISO 8601 standard format is B<%Y-%m-%d>.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:118
msgid "The hour (0-23)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:121
msgid "The hour on a 12-hour clock (1-12)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:124
msgid "The day number in the year (1-366)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:127
msgid "The month number (1-12)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:130
msgid "The minute (0-59)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:133 build/C/man3/strptime.3:157
msgid "Arbitrary whitespace."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:137
msgid "The locale's equivalent of AM or PM.  (Note: there may be none.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:146
msgid ""
"The 12-hour clock time (using the locale's AM or PM).  In the POSIX locale "
"equivalent to B<%I:%M:%S %p>.  If I<t_fmt_ampm> is empty in the B<LC_TIME> "
"part of the current locale then the behavior is undefined."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:150
msgid "Equivalent to B<%H:%M>."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:154
msgid ""
"The second (0-60; 60 may occur for leap seconds; earlier also 61 was "
"allowed)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:161
msgid "Equivalent to B<%H:%M:%S>."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:165
msgid ""
"The week number with Sunday the first day of the week (0-53).  The first "
"Sunday of January is the first day of week 1."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:168
msgid "The weekday number (0-6) with Sunday = 0."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:172
msgid ""
"The week number with Monday the first day of the week (0-53).  The first "
"Monday of January is the first day of week 1."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:175
msgid "The date, using the locale's date format."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:178
msgid "The time, using the locale's time format."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:184
msgid ""
"The year within century (0-99).  When a century is not otherwise specified, "
"values in the range 69-99 refer to years in the twentieth century "
"(1969-1999); values in the range 00-68 refer to years in the twenty-first "
"century (2000-2068)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:187
msgid "The year, including century (for example, 1991)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:193
msgid ""
"Some field descriptors can be modified by the E or O modifier characters to "
"indicate that an alternative format or specification should be used.  If the "
"alternative format or specification does not exist in the current locale, "
"the unmodified field descriptor is used."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:196
msgid ""
"The E modifier specifies that the input string may contain alternative "
"locale-dependent versions of the date and time representation:"
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:196
#, no-wrap
msgid "B<%Ec>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:199
msgid "The locale's alternative date and time representation."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:199
#, no-wrap
msgid "B<%EC>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:202
msgid ""
"The name of the base year (period) in the locale's alternative "
"representation."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:202
#, no-wrap
msgid "B<%Ex>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:205
msgid "The locale's alternative date representation."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:205
#, no-wrap
msgid "B<%EX>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:208
msgid "The locale's alternative time representation."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:208
#, no-wrap
msgid "B<%Ey>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:213
msgid ""
"The offset from B<%EC> (year only) in the locale's alternative "
"representation."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:213
#, no-wrap
msgid "B<%EY>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:216
msgid "The full alternative year representation."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:219
msgid ""
"The O modifier specifies that the numerical input may be in an alternative "
"locale-dependent format:"
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:219
#, no-wrap
msgid "B<%Od> or B<%Oe>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:223
msgid ""
"The day of the month using the locale's alternative numeric symbols; leading "
"zeros are permitted but not required."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:223
#, no-wrap
msgid "B<%OH>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:226
msgid "The hour (24-hour clock) using the locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:226
#, no-wrap
msgid "B<%OI>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:229
msgid "The hour (12-hour clock) using the locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:229
#, no-wrap
msgid "B<%Om>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:232
msgid "The month using the locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:232
#, no-wrap
msgid "B<%OM>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:235
msgid "The minutes using the locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:235
#, no-wrap
msgid "B<%OS>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:238
msgid "The seconds using the locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:238
#, no-wrap
msgid "B<%OU>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:242
msgid ""
"The week number of the year (Sunday as the first day of the week)  using the "
"locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:242
#, no-wrap
msgid "B<%Ow>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:246
msgid ""
"The number of the weekday (Sunday=0) using the locale's alternative numeric "
"symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:246
#, no-wrap
msgid "B<%OW>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:250
msgid ""
"The week number of the year (Monday as the first day of the week)  using the "
"locale's alternative numeric symbols."
msgstr ""

#. type: TP
#: build/C/man3/strptime.3:250
#, no-wrap
msgid "B<%Oy>"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:255
msgid ""
"The year (offset from B<%C>)  using the locale's alternative numeric "
"symbols."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:258
msgid ""
"The broken-down time structure I<tm> is defined in I<E<lt>time.hE<gt>> as "
"follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:272
#, no-wrap
msgid ""
"struct tm {\n"
"    int tm_sec;        /* seconds */\n"
"    int tm_min;        /* minutes */\n"
"    int tm_hour;       /* hours */\n"
"    int tm_mday;       /* day of the month */\n"
"    int tm_mon;        /* month */\n"
"    int tm_year;       /* year */\n"
"    int tm_wday;       /* day of the week */\n"
"    int tm_yday;       /* day in the year */\n"
"    int tm_isdst;      /* daylight saving time */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:288
msgid ""
"The return value of the function is a pointer to the first character not "
"processed in this function call.  In case the input string contains more "
"characters than required by the format string the return value points right "
"after the last consumed input character.  In case the whole input string is "
"consumed the return value points to the null byte at the end of the string.  "
"If B<strptime>()  fails to match all of the format string and therefore an "
"error occurred the function returns NULL."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:302
msgid ""
"In principle, this function does not initialize I<tm> but only stores the "
"values specified.  This means that I<tm> should be initialized before the "
"call.  Details differ a bit between different UNIX systems.  The glibc "
"implementation does not touch those fields which are not explicitly "
"specified, except that it recomputes the I<tm_wday> and I<tm_yday> field if "
"any of the year, month, or day elements changed."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:310
msgid ""
"This function is available since libc 4.6.8.  Linux libc4 and libc5 includes "
"define the prototype unconditionally; glibc2 includes provide a prototype "
"only when B<_XOPEN_SOURCE> or B<_GNU_SOURCE> are defined."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:315
msgid ""
"Before libc 5.4.13 whitespace (and the \\(aqn\\(aq and \\(aqt\\(aq "
"specifications) was not handled, no \\(aqE\\(aq and \\(aqO\\(aq locale "
"modifier characters were accepted, and the \\(aqC\\(aq specification was a "
"synonym for the \\(aqc\\(aq specification."
msgstr ""

#.  In libc4 and libc5 the code for %I is broken (fixed in glibc;
#.  %OI was fixed in glibc 2.2.4).
#. type: Plain text
#: build/C/man3/strptime.3:324
msgid ""
"The \\(aqy\\(aq (year in century) specification is taken to specify a year "
"in the 20th century by libc4 and libc5.  It is taken to be a year in the "
"range 1950-2049 by glibc 2.0.  It is taken to be a year in 1969-2068 since "
"glibc 2.1."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:332
msgid ""
"For reasons of symmetry, glibc tries to support for B<strptime>()  the same "
"format characters as for B<strftime>(3).  (In most cases the corresponding "
"fields are parsed, but no field in I<tm> is changed.)  This leads to"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:335
msgid "Equivalent to B<%Y-%m-%d>, the ISO 8601 date format."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:339
msgid ""
"The year corresponding to the ISO week number, but without the century "
"(0-99)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:343
msgid "The year corresponding to the ISO week number.  (For example, 1991.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:346
msgid "The day of the week as a decimal number (1-7, where Monday = 1)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:353
msgid ""
"The ISO 8601:1988 week number as a decimal number (1-53).  If the week "
"(starting on Monday) containing 1 January has four or more days in the new "
"year, then it is considered week 1.  Otherwise, it is the last week of the "
"previous year, and the next week is week 1."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:356
msgid "An RFC-822/ISO 8601 standard timezone specification."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:359
msgid "The timezone name."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:375
msgid ""
"Similarly, because of GNU extensions to B<strftime>(3), B<%k> is accepted as "
"a synonym for B<%H>, and B<%l> should be accepted as a synonym for B<%I>, "
"and B<%P> is accepted as a synonym for B<%p>.  Finally"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:379
msgid ""
"The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).  "
"Leap seconds are not counted unless leap second support is available."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:382
msgid ""
"The glibc implementation does not require whitespace between two field "
"descriptors."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:387
msgid ""
"The following example demonstrates the use of B<strptime>()  and "
"B<strftime>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:394
#, no-wrap
msgid ""
"#define _XOPEN_SOURCE\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>string.hE<gt>\n"
"#include E<lt>time.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:400
#, no-wrap
msgid ""
"int\n"
"main(void)\n"
"{\n"
"    struct tm tm;\n"
"    char buf[255];\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:407
#, no-wrap
msgid ""
"    memset(&tm, 0, sizeof(struct tm));\n"
"    strptime(\"2001-11-12 18:31:01\", \"%Y-%m-%d %H:%M:%S\", &tm);\n"
"    strftime(buf, sizeof(buf), \"%d %b %Y %H:%M\", &tm);\n"
"    puts(buf);\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strptime.3:414
msgid "B<time>(2), B<getdate>(3), B<scanf>(3), B<setlocale>(3), B<strftime>(3)"
msgstr ""

#. type: TH
#: build/C/man1/time.1:7 build/C/man2/time.2:29 build/C/man7/time.7:26
#, no-wrap
msgid "TIME"
msgstr ""

#. type: TH
#: build/C/man1/time.1:7
#, no-wrap
msgid "2008-11-14"
msgstr ""

#. type: TH
#: build/C/man1/time.1:7
#, no-wrap
msgid "Linux User's Manual"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:10
msgid "time - time a simple command or give resource usage"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:12
msgid "B<time [>I<options>B<] >I<command>B< [>I<arguments...>B<] >"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:42
msgid ""
"The B<time> command runs the specified program I<command> with the given "
"arguments.  When I<command> finishes, B<time> writes a message to standard "
"error giving timing statistics about this program run.  These statistics "
"consist of (i) the elapsed real time between invocation and termination, "
"(ii) the user CPU time (the sum of the I<tms_utime> and I<tms_cutime> values "
"in a I<struct tms> as returned by B<times>(2)), and (iii) the system CPU "
"time (the sum of the I<tms_stime> and I<tms_cstime> values in a I<struct "
"tms> as returned by B<times>(2))."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:51
msgid ""
"Note: some shells (e.g., B<bash>(1))  have a built-in B<time> command that "
"provides less functionality than the command described here.  To access the "
"real command, you may need to specify its pathname (something like "
"I</usr/bin/time>)."
msgstr ""

#. type: SH
#: build/C/man1/time.1:51
#, no-wrap
msgid "OPTIONS"
msgstr ""

#. type: TP
#: build/C/man1/time.1:52
#, no-wrap
msgid "B<-p>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:55
msgid "When in the POSIX locale, use the precise traditional format"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:58
msgid "real %f\\enuser %f\\ensys %f\\en"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:63
msgid ""
"(with numbers in seconds)  where the number of decimals in the output for %f "
"is unspecified but is sufficient to express the clock tick accuracy, and at "
"least one."
msgstr ""

#. type: SH
#: build/C/man1/time.1:63 build/C/man8/tzselect.8:18
#, no-wrap
msgid "EXIT STATUS"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:72
msgid ""
"If I<command> was invoked, the exit status is that of I<command>.  Otherwise "
"it is 127 if I<command> could not be found, 126 if it could be found but "
"could not be invoked, and some other nonzero value (1-125) if something else "
"went wrong."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:86
msgid ""
"The variables B<LANG>, B<LC_ALL>, B<LC_CTYPE>, B<LC_MESSAGES>, "
"B<LC_NUMERIC>, B<NLSPATH>, and B<PATH> are used.  The last one to search for "
"I<command>.  The remaining ones for the text and formatting of the output."
msgstr ""

#. type: SH
#: build/C/man1/time.1:86
#, no-wrap
msgid "GNU VERSION"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:98
msgid ""
"Below a description of the GNU 1.7 version of B<time>.  Disregarding the "
"name of the utility, GNU makes it output lots of useful information, not "
"only about time used, but also on other resources like memory, I/O and IPC "
"calls (where available).  The output is formatted using a format string that "
"can be specified using the I<-f> option or the B<TIME> environment variable."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:100
msgid "The default format string is:"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:103
msgid "%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:105
msgid "%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:111
msgid "When the I<-p> option is given the (portable) output format"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:114
msgid "real %e"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:116
msgid "user %U"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:118
msgid "sys %S"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:122
msgid "is used."
msgstr ""

#. type: SS
#: build/C/man1/time.1:122
#, no-wrap
msgid "The format string"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:135
msgid ""
"The format is interpreted in the usual printf-like way.  Ordinary characters "
"are directly copied, tab, newline and backslash are escaped using \\et, \\en "
"and \\e\\e, a percent sign is represented by %%, and otherwise % indicates a "
"conversion.  The program B<time> will always add a trailing newline itself.  "
"The conversions follow.  All of those used by B<tcsh>(1)  are supported."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:137
msgid "B<Time>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:140
msgid "Elapsed real time (in [hours:]minutes:seconds)."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:143
msgid "(Not in tcsh.) Elapsed real time (in seconds)."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:146
msgid "Total number of CPU-seconds that the process spent in kernel mode."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:149
msgid "Total number of CPU-seconds that the process spent in user mode."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:152
msgid "Percentage of the CPU that this job got, computed as (%U + %S) / %E."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:154
msgid "B<Memory>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:157
msgid "Maximum resident set size of the process during its lifetime, in Kbytes."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:160
msgid "(Not in tcsh.) Average resident set size of the process, in Kbytes."
msgstr ""

#. type: TP
#: build/C/man1/time.1:160
#, no-wrap
msgid "B<%K>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:164
msgid "Average total (data+stack+text) memory use of the process, in Kbytes."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:167
msgid "Average size of the process's unshared data area, in Kbytes."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:170
msgid ""
"(Not in tcsh.) Average size of the process's unshared stack space, in "
"Kbytes."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:173
msgid "Average size of the process's shared text space, in Kbytes."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:177
msgid ""
"(Not in tcsh.) System's page size, in bytes.  This is a per-system constant, "
"but varies between systems."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:181
msgid ""
"Number of major page faults that occurred while the process was running.  "
"These are faults where the page has to be read in from disk."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:188
msgid ""
"Number of minor, or recoverable, page faults.  These are faults for pages "
"that are not valid but which have not yet been claimed by other virtual "
"pages.  Thus the data in the page is still valid but the system tables must "
"be updated."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:191
msgid "Number of times the process was swapped out of main memory."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:195
msgid ""
"Number of times the process was context-switched involuntarily (because the "
"time slice expired)."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:199
msgid ""
"Number of waits: times that the program was context-switched voluntarily, "
"for instance while waiting for an I/O operation to complete."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:201
msgid "B<I/O>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:204
msgid "Number of file system inputs by the process."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:207
msgid "Number of file system outputs by the process."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:210
msgid "Number of socket messages received by the process."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:213
msgid "Number of socket messages sent by the process."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:216
msgid "Number of signals delivered to the process."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:219
msgid "(Not in tcsh.) Name and command-line arguments of the command being timed."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:222
msgid "(Not in tcsh.) Exit status of the command."
msgstr ""

#. type: SS
#: build/C/man1/time.1:222
#, no-wrap
msgid "GNU Options"
msgstr ""

#. type: TP
#: build/C/man1/time.1:223
#, no-wrap
msgid "B<-f >I<FORMAT>B<, --format=>I<FORMAT>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:227
msgid ""
"Specify output format, possibly overriding the format specified in the "
"environment variable TIME."
msgstr ""

#. type: TP
#: build/C/man1/time.1:227
#, no-wrap
msgid "B<-p, --portability>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:230
msgid "Use the portable output format."
msgstr ""

#. type: TP
#: build/C/man1/time.1:230
#, no-wrap
msgid "B<-o >I<FILE>B<, --output=>I<FILE>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:233
msgid "Do not send the results to I<stderr>, but overwrite the specified file."
msgstr ""

#. type: TP
#: build/C/man1/time.1:233
#, no-wrap
msgid "B<-a, --append>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:236
msgid "(Used together with -o.) Do not overwrite but append."
msgstr ""

#. type: TP
#: build/C/man1/time.1:236
#, no-wrap
msgid "B<-v, --verbose>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:239
msgid "Give very verbose output about all the program knows about."
msgstr ""

#. type: SS
#: build/C/man1/time.1:239
#, no-wrap
msgid "GNU Standard Options"
msgstr ""

#. type: TP
#: build/C/man1/time.1:240
#, no-wrap
msgid "B<--help>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:243
msgid "Print a usage message on standard output and exit successfully."
msgstr ""

#. type: TP
#: build/C/man1/time.1:243
#, no-wrap
msgid "B<-V, --version>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:246
msgid "Print version information on standard output, then exit successfully."
msgstr ""

#. type: TP
#: build/C/man1/time.1:246
#, no-wrap
msgid "B<-->"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:249
msgid "Terminate option list."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:254
msgid ""
"Not all resources are measured by all versions of UNIX, so some of the "
"values might be reported as zero.  The present selection was mostly inspired "
"by the data provided by 4.2 or 4.3BSD."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:257
msgid ""
"GNU time version 1.7 is not yet localized.  Thus, it does not implement the "
"POSIX requirements."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:269
msgid ""
"The environment variable B<TIME> was badly chosen.  It is not unusual for "
"systems like B<autoconf>(1)  or B<make>(1)  to use environment variables "
"with the name of a utility to override the utility to be used.  Uses like "
"MORE or TIME for options to programs (instead of program pathnames) tend to "
"lead to difficulties."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:276
msgid ""
"It seems unfortunate that I<-o> overwrites instead of appends.  (That is, "
"the I<-a> option should be the default.)"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:280
msgid "Mail suggestions and bug reports for GNU B<time> to"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:282
msgid "I<bug-utils@prep.ai.mit.edu>"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:286
msgid "Please include the version of B<time>, which you can get by running"
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:288
msgid "I<time --version>"
msgstr ""

#.  .SH AUTHORS
#.  .TP
#.  .IP "David Keppel"
#.  Original version
#.  .IP "David MacKenzie"
#.  POSIXization, autoconfiscation, GNU getoptization,
#.  documentation, other bug fixes and improvements.
#.  .IP "Arne Henrik Juul"
#.  Helped with portability
#.  .IP "Francois Pinard"
#.  Helped with portability
#. type: Plain text
#: build/C/man1/time.1:302
msgid "and the operating system and C compiler you used."
msgstr ""

#. type: Plain text
#: build/C/man1/time.1:306
msgid "B<tcsh>(1), B<times>(2), B<wait3>(2)"
msgstr ""

#. type: TH
#: build/C/man2/time.2:29
#, no-wrap
msgid "2011-09-09"
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:32
msgid "time - get time in seconds"
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:36
msgid "B<time_t time(time_t *>I<t>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:40
msgid ""
"B<time>()  returns the time as the number of seconds since the Epoch, "
"1970-01-01 00:00:00 +0000 (UTC)."
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:46
msgid ""
"If I<t> is non-NULL, the return value is also stored in the memory pointed "
"to by I<t>."
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:50
msgid ""
"On success, the value of time in seconds since the Epoch is returned.  On "
"error, I<((time_t)\\ -1)> is returned, and I<errno> is set appropriately."
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:55
msgid "I<t> points outside your accessible address space."
msgstr ""

#.  .br
#.  Under 4.3BSD, this call is obsoleted by
#.  .BR gettimeofday (2).
#. type: Plain text
#: build/C/man2/time.2:61
msgid ""
"SVr4, 4.3BSD, C89, C99, POSIX.1-2001.  POSIX does not specify any error "
"conditions."
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:76
msgid ""
"POSIX.1 defines I<seconds since the Epoch> using a formula that approximates "
"the number of seconds between a specified time and the Epoch.  This formula "
"takes account of the facts that all years that are evenly divisible by 4 are "
"leap years, but years that are evenly divisible by 100 are not leap years "
"unless they are also evenly divisible by 400, in which case they are leap "
"years.  This value is not the same as the actual number of seconds between "
"the time and the Epoch, because of leap seconds and because system clocks "
"are not required to be synchronized to a standard reference.  The intention "
"is that the interpretation of seconds since the Epoch values be consistent; "
"see POSIX.1-2008 Rationale A.4.15 for further rationale."
msgstr ""

#. type: Plain text
#: build/C/man2/time.2:82
msgid "B<date>(1), B<gettimeofday>(2), B<ctime>(3), B<ftime>(3), B<time>(7)"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:29
msgid "time - overview of time and timers"
msgstr ""

#. type: SS
#: build/C/man7/time.7:30
#, no-wrap
msgid "Real time and process time"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:37
msgid ""
"I<Real time> is defined as time measured from some fixed point, either from "
"a standard point in the past (see the description of the Epoch and calendar "
"time below), or from some point (e.g., the start) in the life of a process "
"(I<elapsed time>)."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:57
msgid ""
"I<Process time> is defined as the amount of CPU time used by a process.  "
"This is sometimes divided into I<user> and I<system> components.  User CPU "
"time is the time spent executing code in user mode.  System CPU time is the "
"time spent by the kernel executing in system mode on behalf of the process "
"(e.g., executing system calls).  The B<time>(1)  command can be used to "
"determine the amount of CPU time consumed during the execution of a "
"program.  A program can determine the amount of CPU time it has consumed "
"using B<times>(2), B<getrusage>(2), or B<clock>(3)."
msgstr ""

#. type: SS
#: build/C/man7/time.7:57
#, no-wrap
msgid "The Hardware Clock"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:64
msgid ""
"Most computers have a (battery-powered) hardware clock which the kernel "
"reads at boot time in order to initialize the software clock.  For further "
"details, see B<rtc>(4)  and B<hwclock>(8)."
msgstr ""

#. type: SS
#: build/C/man7/time.7:64
#, no-wrap
msgid "The Software Clock, HZ, and Jiffies"
msgstr ""

#.  semtimedop(), mq_timedwait(), io_getevents(), poll() are the same
#.  futexes and thus sem_timedwait() seem to use high-res timers.
#. type: Plain text
#: build/C/man7/time.7:79
msgid ""
"The accuracy of various system calls that set timeouts, (e.g., B<select>(2), "
"B<sigtimedwait>(2))  and measure CPU time (e.g., B<getrusage>(2))  is "
"limited by the resolution of the I<software clock>, a clock maintained by "
"the kernel which measures time in I<jiffies>.  The size of a jiffy is "
"determined by the value of the kernel constant I<HZ>."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:94
msgid ""
"The value of I<HZ> varies across kernel versions and hardware platforms.  On "
"i386 the situation is as follows: on kernels up to and including 2.4.x, HZ "
"was 100, giving a jiffy value of 0.01 seconds; starting with 2.6.0, HZ was "
"raised to 1000, giving a jiffy of 0.001 seconds.  Since kernel 2.6.13, the "
"HZ value is a kernel configuration parameter and can be 100, 250 (the "
"default) or 1000, yielding a jiffies value of, respectively, 0.01, 0.004, or "
"0.001 seconds.  Since kernel 2.6.20, a further frequency is available: 300, "
"a number that divides evenly for the common video frame rates (PAL, 25 HZ; "
"NTSC, 30 HZ)."
msgstr ""

#.  glibc gets this info with a little help from the ELF loader;
#.  see glibc elf/dl-support.c and kernel fs/binfmt_elf.c.
#. type: Plain text
#: build/C/man7/time.7:105
msgid ""
"The B<times>(2)  system call is a special case.  It reports times with a "
"granularity defined by the kernel constant I<USER_HZ>.  Userspace "
"applications can determine the value of this constant using "
"I<sysconf(_SC_CLK_TCK)>."
msgstr ""

#. type: SS
#: build/C/man7/time.7:105
#, no-wrap
msgid "High-Resolution Timers"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:108
msgid ""
"Before Linux 2.6.21, the accuracy of timer and sleep system calls (see "
"below) was also limited by the size of the jiffy."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:121
msgid ""
"Since Linux 2.6.21, Linux supports high-resolution timers (HRTs), optionally "
"configurable via B<CONFIG_HIGH_RES_TIMERS>.  On a system that supports HRTs, "
"the accuracy of sleep and timer system calls is no longer constrained by the "
"jiffy, but instead can be as accurate as the hardware allows (microsecond "
"accuracy is typical of modern hardware).  You can determine whether "
"high-resolution timers are supported by checking the resolution returned by "
"a call to B<clock_getres>(2)  or looking at the \"resolution\" entries in "
"I</proc/timer_list>."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:124
msgid ""
"HRTs are not supported on all hardware architectures.  (Support is provided "
"on x86, arm, and powerpc, among others.)"
msgstr ""

#. type: SS
#: build/C/man7/time.7:124
#, no-wrap
msgid "The Epoch"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:128
msgid ""
"UNIX systems represent time in seconds since the I<Epoch>, 1970-01-01 "
"00:00:00 +0000 (UTC)."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:140
msgid ""
"A program can determine the I<calendar time> using B<gettimeofday>(2), which "
"returns time (in seconds and microseconds) that have elapsed since the "
"Epoch; B<time>(2)  provides similar information, but only with accuracy to "
"the nearest second.  The system time can be changed using "
"B<settimeofday>(2)."
msgstr ""

#. type: SS
#: build/C/man7/time.7:140
#, no-wrap
msgid "Broken-down time"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:158
msgid ""
"Certain library functions use a structure of type I<tm> to represent "
"I<broken-down time>, which stores time value separated out into distinct "
"components (year, month, day, hour, minute, second, etc.).  This structure "
"is described in B<ctime>(3), which also describes functions that convert "
"between calendar time and broken-down time.  Functions for converting "
"between broken-down time and printable string representations of the time "
"are described in B<ctime>(3), B<strftime>(3), and B<strptime>(3)."
msgstr ""

#. type: SS
#: build/C/man7/time.7:158
#, no-wrap
msgid "Sleeping and Setting Timers"
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:165
msgid ""
"Various system calls and functions allow a program to sleep (suspend "
"execution) for a specified period of time; see B<nanosleep>(2), "
"B<clock_nanosleep>(2), and B<sleep>(3)."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:174
msgid ""
"Various system calls allow a process to set a timer that expires at some "
"point in the future, and optionally at repeated intervals; see B<alarm>(2), "
"B<getitimer>(2), B<timerfd_create>(2), and B<timer_create>(2)."
msgstr ""

#. type: Plain text
#: build/C/man7/time.7:204
msgid ""
"B<date>(1), B<time>(1), B<adjtimex>(2), B<alarm>(2), B<clock_gettime>(2), "
"B<clock_nanosleep>(2), B<getitimer>(2), B<getrlimit>(2), B<getrusage>(2), "
"B<gettimeofday>(2), B<nanosleep>(2), B<stat>(2), B<time>(2), "
"B<timer_create>(2), B<timerfd_create>(2), B<times>(2), B<utime>(2), "
"B<adjtime>(3), B<clock>(3), B<clock_getcpuclockid>(3), B<ctime>(3), "
"B<pthread_getcpuclockid>(3), B<sleep>(3), B<strftime>(3), B<strptime>(3), "
"B<timeradd>(3), B<usleep>(3), B<rtc>(4), B<hwclock>(8)"
msgstr ""

#. type: TH
#: build/C/man3/timegm.3:23
#, no-wrap
msgid "TIMEGM"
msgstr ""

#. type: TH
#: build/C/man3/timegm.3:23
#, no-wrap
msgid "2007-07-26"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:26
msgid "timegm, timelocal - inverses of gmtime and localtime"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:31
#, no-wrap
msgid "B<time_t timelocal(struct tm *>I<tm>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:33
#, no-wrap
msgid "B<time_t timegm(struct tm *>I<tm>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:43
msgid "B<timelocal>(), B<timegm>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:52
msgid ""
"The functions B<timelocal>()  and B<timegm>()  are the inverses of "
"B<localtime>(3)  and B<gmtime>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:56
msgid ""
"These functions are nonstandard GNU extensions that are also present on the "
"BSDs.  Avoid their use; see NOTES."
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:62
msgid ""
"The B<timelocal>()  function is equivalent to the POSIX standard function "
"B<mktime>(3).  There is no reason to ever use it."
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:72
msgid ""
"For a portable version of B<timegm>(), set the B<TZ> environment variable to "
"UTC, call B<mktime>(3)  and restore the value of B<TZ>.  Something like"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:77
#, no-wrap
msgid ""
"#include E<lt>time.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:83
#, no-wrap
msgid ""
"time_t\n"
"my_timegm(struct tm *tm)\n"
"{\n"
"    time_t ret;\n"
"    char *tz;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:95
#, no-wrap
msgid ""
"    tz = getenv(\"TZ\");\n"
"    setenv(\"TZ\", \"\", 1);\n"
"    tzset();\n"
"    ret = mktime(tm);\n"
"    if (tz)\n"
"        setenv(\"TZ\", tz, 1);\n"
"    else\n"
"        unsetenv(\"TZ\");\n"
"    tzset();\n"
"    return ret;\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timegm.3:102
msgid "B<gmtime>(3), B<localtime>(3), B<mktime>(3), B<tzset>(3)"
msgstr ""

#. type: TH
#: build/C/man3/timeradd.3:25
#, no-wrap
msgid "TIMERADD"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:28
msgid "timeradd, timersub, timercmp, timerclear, timerisset - timeval operations"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:34
#, no-wrap
msgid ""
"B<void timeradd(struct timeval *>I<a>B<, struct timeval *>I<b>B<,>\n"
"B<              struct timeval *>I<res>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:37
#, no-wrap
msgid ""
"B<void timersub(struct timeval *>I<a>B<, struct timeval *>I<b>B<,>\n"
"B<              struct timeval *>I<res>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:39
#, no-wrap
msgid "B<void timerclear(struct timeval *>I<tvp>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:41
#, no-wrap
msgid "B<int timerisset(struct timeval *>I<tvp>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:43
#, no-wrap
msgid ""
"B<int timercmp(struct timeval *>I<a>B<, struct timeval *>I<b>B<, "
">I<CMP>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:52
msgid "All functions shown above: _BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:58
msgid ""
"The macros are provided to operate on I<timeval> structures, defined in "
"I<E<lt>sys/time.hE<gt>> as:"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:80
msgid ""
"B<timeradd>()  adds the time values in I<a> and I<b>, and places the sum in "
"the I<timeval> pointed to by I<res>.  The result is normalized such that "
"I<res-E<gt>tv_usec> has a value in the range 0 to 999,999."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:93
msgid ""
"B<timersub>()  subtracts the time value in I<b> from the time value in I<a>, "
"and places the result in the I<timeval> pointed to by I<res>.  The result is "
"normalized such that I<res-E<gt>tv_usec> has a value in the range 0 to "
"999,999."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:100
msgid ""
"B<timerclear>()  zeros out the I<timeval> structure pointed to by I<tvp>, so "
"that it represents the Epoch: 1970-01-01 00:00:00 +0000 (UTC)."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:107
msgid ""
"B<timerisset>()  returns true (nonzero) if either field of the I<timeval> "
"structure pointed to by I<tvp> contains a nonzero value."
msgstr ""

#.  HP-UX, Tru64, Irix have a definition like:
#. #define timercmp(tvp, uvp, cmp) \
#.     ((tvp)->tv_sec cmp (uvp)->tv_sec || \
#.     (tvp)->tv_sec == (uvp)->tv_sec && (tvp)->tv_usec cmp (uvp)->tv_usec)
#. type: Plain text
#: build/C/man3/timeradd.3:134
msgid ""
"B<timercmp>()  compares the timer values in I<a> and I<b> using the "
"comparison operator I<CMP>, and returns true (nonzero) or false (0) "
"depending on the result of the comparison.  Some systems (but not "
"Linux/glibc), have a broken B<timercmp>()  implementation, in which I<CMP> "
"of I<E<gt>=>, I<E<lt>=>, and I<==> do not work; portable applications can "
"instead use"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:138
#, no-wrap
msgid ""
"    !timercmp(..., E<lt>)\n"
"    !timercmp(..., E<gt>)\n"
"    !timercmp(..., !=)\n"
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:143
msgid "B<timerisset>()  and B<timercmp>()  return true (nonzero) or false (0)."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:145
msgid "No errors are defined."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:148
msgid "Not in POSIX.1-2001.  Present on most BSD derivatives."
msgstr ""

#. type: Plain text
#: build/C/man3/timeradd.3:151
msgid "B<gettimeofday>(2), B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man2/times.2:38
#, no-wrap
msgid "TIMES"
msgstr ""

#. type: TH
#: build/C/man2/times.2:38
#, no-wrap
msgid "2012-04-16"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:41
msgid "times - get process times"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:43
msgid "B<#include E<lt>sys/times.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:45
msgid "B<clock_t times(struct tms *>I<buf>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:56
msgid ""
"B<times>()  stores the current process times in the I<struct tms> that "
"I<buf> points to.  The I<struct tms> is as defined in "
"I<E<lt>sys/times.hE<gt>>:"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:65
#, no-wrap
msgid ""
"struct tms {\n"
"    clock_t tms_utime;  /* user time */\n"
"    clock_t tms_stime;  /* system time */\n"
"    clock_t tms_cutime; /* user time of children */\n"
"    clock_t tms_cstime; /* system time of children */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:90
msgid ""
"The I<tms_utime> field contains the CPU time spent executing instructions of "
"the calling process.  The I<tms_stime> field contains the CPU time spent in "
"the system while executing tasks on behalf of the calling process.  The "
"I<tms_cutime> field contains the sum of the I<tms_utime> and I<tms_cutime> "
"values for all waited-for terminated children.  The I<tms_cstime> field "
"contains the sum of the I<tms_stime> and I<tms_cstime> values for all "
"waited-for terminated children."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:99
msgid ""
"Times for terminated children (and their descendants)  are added in at the "
"moment B<wait>(2)  or B<waitpid>(2)  returns their process ID.  In "
"particular, times of grandchildren that the children did not wait for are "
"never seen."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:101
msgid "All times reported are in clock ticks."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:110
msgid ""
"B<times>()  returns the number of clock ticks that have elapsed since an "
"arbitrary point in the past.  The return value may overflow the possible "
"range of type I<clock_t>.  On error, I<(clock_t)\\ -1> is returned, and "
"I<errno> is set appropriately."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:115
msgid "I<tms> points outside the process's address space."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:117
msgid "SVr4, 4.3BSD, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:119
msgid "The number of clock ticks per second can be obtained using:"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:122
msgid "sysconf(_SC_CLK_TCK);"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:128
msgid ""
"In POSIX.1-1996 the symbol B<CLK_TCK> (defined in I<E<lt>time.hE<gt>>)  is "
"mentioned as obsolescent.  It is obsolete now."
msgstr ""

#.  See the description of times() in XSH, which says:
#. 	The times of a terminated child process are included... when wait()
#. 	or waitpid() returns the process ID of this terminated child.
#. type: Plain text
#: build/C/man2/times.2:147
msgid ""
"In Linux kernel versions before 2.6.9, if the disposition of B<SIGCHLD> is "
"set to B<SIG_IGN> then the times of terminated children are automatically "
"included in the I<tms_cstime> and I<tms_cutime> fields, although "
"POSIX.1-2001 says that this should only happen if the calling process "
"B<wait>(2)s on its children.  This nonconformance is rectified in Linux "
"2.6.9 and later."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:156
msgid ""
"On Linux, the I<buf> argument can be specified as NULL, with the result that "
"B<times>()  just returns a function result.  However, POSIX does not specify "
"this behavior, and most other UNIX implementations require a non-NULL value "
"for I<buf>."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:165
msgid ""
"Note that B<clock>(3)  also returns a value of type I<clock_t>, but this "
"value is measured in units of B<CLOCKS_PER_SEC>, not the clock ticks used by "
"B<times>()."
msgstr ""

#.  .PP
#.  On older systems the number of clock ticks per second is given
#.  by the variable HZ.
#. type: Plain text
#: build/C/man2/times.2:182
msgid ""
"On Linux, the \"arbitrary point in the past\" from which the return value of "
"B<times>()  is measured has varied across kernel versions.  On Linux 2.4 and "
"earlier this point is the moment the system was booted.  Since Linux 2.6, "
"this point is I<(2^32/HZ) - 300> (i.e., about 429 million) seconds before "
"system boot time.  This variability across kernel versions (and across UNIX "
"implementations), combined with the fact that the returned value may "
"overflow the range of I<clock_t>, means that a portable application would be "
"wise to avoid using this value.  To measure changes in elapsed time, use "
"B<gettimeofday>(2)  instead."
msgstr ""

#. type: SS
#: build/C/man2/times.2:182
#, no-wrap
msgid "Historical"
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:193
msgid ""
"SVr1-3 returns I<long> and the struct members are of type I<time_t> although "
"they store clock ticks, not seconds since the Epoch.  V7 used I<long> for "
"the struct members, because it had no type I<time_t> yet."
msgstr ""

#.  The problem is that a syscall return of -4095 to -1
#.  is interpreted by glibc as an error, and the wrapper converts
#.  the return value to -1.
#.  http://marc.info/?l=linux-kernel&m=119447727031225&w=2
#.  "compat_sys_times() bogus until jiffies >= 0"
#.  November 2007
#. type: Plain text
#: build/C/man2/times.2:208
msgid ""
"A limitation of the Linux system call conventions on some architectures "
"(notably i386) means that on Linux 2.6 there is a small time window (41 "
"seconds) soon after boot when B<times>()  can return -1, falsely indicating "
"that an error occurred.  The same problem can occur when the return value "
"wraps passed the maximum value that can be stored in B<clock_t>."
msgstr ""

#. type: Plain text
#: build/C/man2/times.2:215
msgid ""
"B<time>(1), B<getrusage>(2), B<wait>(2), B<clock>(3), B<sysconf>(3), "
"B<time>(7)"
msgstr ""

#. type: TH
#: build/C/man5/tzfile.5:4
#, no-wrap
msgid "TZFILE"
msgstr ""

#. type: TH
#: build/C/man5/tzfile.5:4
#, no-wrap
msgid "2010-08-31"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:7
msgid "tzfile - timezone information"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:9
msgid "B<#include E<lt>tzfile.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:23
msgid ""
"The timezone information files used by B<tzset>(3)  begin with the magic "
"characters \"TZif\" to identify then as timezone information files, followed "
"by a character identifying the version of the file's format (as of 2005, "
"either an ASCII NUL (\\(aq\\e0\\(aq) or a \\(aq2\\(aq)  followed by fifteen "
"bytes containing zeros reserved for future use, followed by six four-byte "
"values of type I<long>, written in a \"standard\" byte order (the high-order "
"byte of the value is written first).  These values are, in order:"
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:23
#, no-wrap
msgid "I<tzh_ttisgmtcnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:26
msgid "The number of UTC/local indicators stored in the file."
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:26
#, no-wrap
msgid "I<tzh_ttisstdcnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:29
msgid "The number of standard/wall indicators stored in the file."
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:29
#, no-wrap
msgid "I<tzh_leapcnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:32
msgid "The number of leap seconds for which data is stored in the file."
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:32
#, no-wrap
msgid "I<tzh_timecnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:36
msgid "The number of \"transition times\" for which data is stored in the file."
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:36
#, no-wrap
msgid "I<tzh_typecnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:40
msgid ""
"The number of \"local time types\" for which data is stored in the file "
"(must not be zero)."
msgstr ""

#. type: TP
#: build/C/man5/tzfile.5:40
#, no-wrap
msgid "I<tzh_charcnt>"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:44
msgid ""
"The number of characters of \"timezone abbreviation strings\" stored in the "
"file."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:66
msgid ""
"The above header is followed by I<tzh_timecnt> four-byte values of type "
"I<long>, sorted in ascending order.  These values are written in "
"\"standard\" byte order.  Each is used as a transition time (as returned by "
"B<time>(2))  at which the rules for computing local time change.  Next come "
"I<tzh_timecnt> one-byte values of type I<unsigned char>; each one tells "
"which of the different types of \"local time\" types described in the file "
"is associated with the same-indexed transition time.  These values serve as "
"indices into an array of I<ttinfo> structures (with I<tzh_typecnt> entries) "
"that appear next in the file; these structures are defined as follows:"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:74
#, no-wrap
msgid ""
"struct ttinfo {\n"
"    long         tt_gmtoff;\n"
"    int          tt_isdst;\n"
"    unsigned int tt_abbrind;\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:99
msgid ""
"Each structure is written as a four-byte value for I<tt_gmtoff> of type "
"I<long>, in a standard byte order, followed by a one-byte value for "
"I<tt_isdst> and a one-byte value for I<tt_abbrind>.  In each structure, "
"I<tt_gmtoff> gives the number of seconds to be added to UTC, I<tt_isdst> "
"tells whether I<tm_isdst> should be set by B<localtime>(3), and "
"I<tt_abbrind> serves as an index into the array of timezone abbreviation "
"characters that follow the I<ttinfo> structure(s) in the file."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:111
msgid ""
"Then there are I<tzh_leapcnt> pairs of four-byte values, written in standard "
"byte order; the first value of each pair gives the time (as returned by "
"B<time>(2))  at which a leap second occurs; the second gives the I<total> "
"number of leap seconds to be applied after the given time.  The pairs of "
"values are sorted in ascending order by time."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:119
msgid ""
"Then there are I<tzh_ttisstdcnt> standard/wall indicators, each stored as a "
"one-byte value; they tell whether the transition times associated with local "
"time types were specified as standard time or wall clock time, and are used "
"when a timezone file is used in handling POSIX-style timezone environment "
"variables."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:127
msgid ""
"Finally, there are I<tzh_ttisgmtcnt> UTC/local indicators, each stored as a "
"one-byte value; they tell whether the transition times associated with local "
"time types were specified as UTC or local time, and are used when a timezone "
"file is used in handling POSIX-style timezone environment variables."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:139
msgid ""
"B<localtime>(3)  uses the first standard-time I<ttinfo> structure in the "
"file (or simply the first I<ttinfo> structure in the absence of a "
"standard-time structure)  if either I<tzh_timecnt> is zero or the time "
"argument is less than the first transition time recorded in the file."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:149
msgid ""
"For version-2-format timezone files, the above header and data is followed "
"by a second header and data, identical in format except that eight bytes are "
"used for each transition time or leap-second time.  After the second header "
"and data comes a newline-enclosed, POSIX-TZ-environment-variable-style "
"string for use in handling instants after the last transition time stored in "
"the file (with nothing between the newlines if there is no POSIX "
"representation for such instants)."
msgstr ""

#. type: Plain text
#: build/C/man5/tzfile.5:151
msgid "B<ctime>(3)"
msgstr ""

#. type: TH
#: build/C/man8/tzselect.8:3
#, no-wrap
msgid "TZSELECT"
msgstr ""

#. type: TH
#: build/C/man8/tzselect.8:3 build/C/man8/zdump.8:3
#, no-wrap
msgid "2007-05-18"
msgstr ""

#. type: TH
#: build/C/man8/tzselect.8:3 build/C/man8/zdump.8:3 build/C/man8/zic.8:3
#, no-wrap
msgid "Linux System Administration"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:6
msgid "tzselect - select a timezone"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:8
msgid "B<tzselect>"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:16
msgid ""
"The B<tzselect> program asks the user for information about the current "
"location, and outputs the resulting timezone description to standard "
"output.  The output is suitable as a value for the B<TZ> environment "
"variable."
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:18
msgid "All interaction with the user is done via standard input and standard error."
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:21
msgid ""
"The exit status is zero if a timezone was successfully obtained from the "
"user, nonzero otherwise."
msgstr ""

#. type: TP
#: build/C/man8/tzselect.8:22
#, no-wrap
msgid "B<AWK>"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:28
msgid "Name of a Posix-compliant I<awk> program (default: B<awk>)."
msgstr ""

#. type: TP
#: build/C/man8/tzselect.8:28
#, no-wrap
msgid "B<TZDIR>"
msgstr ""

#.  or perhaps /usr/local/etc/zoneinfo in some older systems.
#. type: Plain text
#: build/C/man8/tzselect.8:33
msgid ""
"Name of the directory containing timezone data files (default: "
"I</usr/share/zoneinfo>)."
msgstr ""

#. type: TP
#: build/C/man8/tzselect.8:34
#, no-wrap
msgid "B<TZDIR>I</iso3166.tab>"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:37
msgid "Table of ISO 3166 2-letter country codes and country names."
msgstr ""

#. type: TP
#: build/C/man8/tzselect.8:37
#, no-wrap
msgid "B<TZDIR>I</zone.tab>"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:41
msgid ""
"Table of country codes, latitude and longitude, TZ values, and descriptive "
"comments."
msgstr ""

#. type: TP
#: build/C/man8/tzselect.8:41
#, no-wrap
msgid "B<TZDIR>I</>I<TZ>"
msgstr ""

#. type: Plain text
#: build/C/man8/tzselect.8:44
msgid "Time zone data file for timezone I<TZ>."
msgstr ""

#.  @(#)tzselect.8	1.3
#. type: Plain text
#: build/C/man8/tzselect.8:49
msgid "B<tzfile>(5), B<zdump>(8), B<zic>(8)"
msgstr ""

#. type: TH
#: build/C/man3/tzset.3:31
#, no-wrap
msgid "TZSET"
msgstr ""

#. type: TH
#: build/C/man3/tzset.3:31 build/C/man2/utimensat.2:26
#, no-wrap
msgid "2012-03-25"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:34
msgid "tzset, tzname, timezone, daylight - initialize time conversion information"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:39
#, no-wrap
msgid "B<void tzset (void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:43
#, no-wrap
msgid ""
"B<extern char *>I<tzname>B<[2];>\n"
"B<extern long >I<timezone>B<;>\n"
"B<extern int >I<daylight>B<;>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:52
msgid "B<tzset>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:55
msgid "I<tzname>: _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:58
msgid "I<timezone>: _SVID_SOURCE || _XOPEN_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:61
msgid "I<daylight>: _SVID_SOURCE || _XOPEN_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:73
msgid ""
"The B<tzset>()  function initializes the I<tzname> variable from the B<TZ> "
"environment variable.  This function is automatically called by the other "
"time conversion functions that depend on the timezone.  In a System-V-like "
"environment, it will also set the variables I<timezone> (seconds West of "
"UTC) and I<daylight> (to 0 if this timezone does not have any daylight "
"saving time rules, or to nonzero if there is a time during the year when "
"daylight saving time applies)."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:85
msgid ""
"If the B<TZ> variable does not appear in the environment, the I<tzname> "
"variable is initialized with the best approximation of local wall clock "
"time, as specified by the B<tzfile>(5)-format file I<localtime> found in the "
"system timezone directory (see below).  (One also often sees "
"I</etc/localtime> used here, a symlink to the right file in the system "
"timezone directory.)"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:91
msgid ""
"If the B<TZ> variable does appear in the environment but its value is empty "
"or its value cannot be interpreted using any of the formats specified below, "
"Coordinated Universal Time (UTC) is used."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:97
msgid ""
"The value of B<TZ> can be one of three formats.  The first format is used "
"when there is no daylight saving time in the local timezone:"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:100
msgid "I<std offset>"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:112
msgid ""
"The I<std> string specifies the name of the timezone and must be three or "
"more alphabetic characters.  The I<offset> string immediately follows I<std> "
"and specifies the time value to be added to the local time to get "
"Coordinated Universal Time (UTC).  The I<offset> is positive if the local "
"timezone is west of the Prime Meridian and negative if it is east.  The hour "
"must be between 0 and 24, and the minutes and seconds 0 and 59."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:114
msgid "The second format is used when there is daylight saving time:"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:117
msgid "I<std offset dst [offset],start[/time],end[/time]>"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:126
msgid ""
"There are no spaces in the specification.  The initial I<std> and I<offset> "
"specify the standard timezone, as described above.  The I<dst> string and "
"I<offset> specify the name and offset for the corresponding daylight saving "
"timezone.  If the offset is omitted, it default to one hour ahead of "
"standard time."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:131
msgid ""
"The I<start> field specifies when daylight saving time goes into effect and "
"the I<end> field specifies when the change is made back to standard time.  "
"These fields may have the following formats:"
msgstr ""

#. type: TP
#: build/C/man3/tzset.3:131
#, no-wrap
msgid "JI<n>"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:137
msgid ""
"This specifies the Julian day with I<n> between 1 and 365.  Leap days are "
"not counted.  In this format, February 29 can't be represented; February 28 "
"is day 59, and March 1 is always day 60."
msgstr ""

#. type: TP
#: build/C/man3/tzset.3:137
#, no-wrap
msgid "I<n>"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:141
msgid ""
"This specifies the zero-based Julian day with I<n> between 0 and 365.  "
"February 29 is counted in leap years."
msgstr ""

#. type: TP
#: build/C/man3/tzset.3:141
#, no-wrap
msgid "MI<m>.I<w>.I<d>"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:149
msgid ""
"This specifies day I<d> (0 E<lt>= I<d> E<lt>= 6) of week I<w> (1 E<lt>= I<w> "
"E<lt>= 5) of month I<m> (1 E<lt>= I<m> E<lt>= 12).  Week 1 is the first week "
"in which day I<d> occurs and week 5 is the last week in which day I<d> "
"occurs.  Day 0 is a Sunday."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:153
msgid ""
"The I<time> fields specify when, in the local time currently in effect, the "
"change to the other time occurs.  If omitted, the default is 02:00:00."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:159
msgid ""
"Here is an example for New Zealand, where the standard time (NZST) is 12 "
"hours ahead of UTC, and daylight saving time (NZDT), 13 hours ahead of UTC, "
"runs from the first Sunday in October to the third Sunday in March, and the "
"changeovers happen at the default time of 02:00:00:"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:162
#, no-wrap
msgid "    TZ=\"NZST-12:00:00NZDT-13:00:00,M10.1.0,M3.3.0\"\n"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:166
msgid ""
"The third format specifies that the timezone information should be read from "
"a file:"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:169
msgid ":[filespec]"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:184
msgid ""
"If the file specification I<filespec> is omitted, the timezone information "
"is read from the file I<localtime> in the system timezone directory, which "
"nowadays usually is I</usr/share/zoneinfo>.  This file is in B<tzfile>(5)  "
"format.  If I<filespec> is given, it specifies another B<tzfile>(5)-format "
"file to read the timezone information from.  If I<filespec> does not begin "
"with a \\(aq/\\(aq, the file specification is relative to the system "
"timezone directory."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:186
msgid "Here's an example, once more for New Zealand:"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:189
#, no-wrap
msgid "    TZ=\":Pacific/Auckland\"\n"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:202
msgid ""
"The system timezone directory used depends on the (g)libc version.  Libc4 "
"and libc5 use I</usr/lib/zoneinfo>, and, since libc-5.4.6, when this doesn't "
"work, will try I</usr/share/zoneinfo>.  Glibc2 will use the environment "
"variable B<TZDIR>, when that exists.  Its default depends on how it was "
"installed, but normally is I</usr/share/zoneinfo>."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:204
msgid "This timezone directory contains the files"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:207
#, no-wrap
msgid ""
"localtime      local timezone file\n"
"posixrules     rules for POSIX-style TZ's\n"
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:214
msgid ""
"Often I</etc/localtime> is a symlink to the file I<localtime> or to the "
"correct timezone file in the system timezone directory."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:216
msgid "SVr4, POSIX.1-2001, 4.3BSD."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:223
msgid ""
"Note that the variable I<daylight> does not indicate that daylight saving "
"time applies right now.  It used to give the number of some algorithm (see "
"the variable I<tz_dsttime> in B<gettimeofday>(2)).  It has been obsolete for "
"many years but is required by SUSv2."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:231
msgid ""
"4.3BSD had a function B<char *timezone(>I<zone>B<, >I<dst>B<)> that returned "
"the name of the timezone corresponding to its first argument (minutes West "
"of UTC).  If the second argument was 0, the standard name was used, "
"otherwise the daylight saving time version."
msgstr ""

#. type: Plain text
#: build/C/man3/tzset.3:238
msgid ""
"B<date>(1), B<gettimeofday>(2), B<time>(2), B<ctime>(3), B<getenv>(3), "
"B<tzfile>(5)"
msgstr ""

#. type: TH
#: build/C/man2/utime.2:31
#, no-wrap
msgid "UTIME"
msgstr ""

#. type: TH
#: build/C/man2/utime.2:31
#, no-wrap
msgid "2008-08-06"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:34
msgid "utime, utimes - change file last access and modification times"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:37
#, no-wrap
msgid "B<#include E<lt>sys/types.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:39
#, no-wrap
msgid "B<#include E<lt>utime.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:41
#, no-wrap
msgid ""
"B<int utime(const char *>I<filename>B<, const struct utimbuf "
"*>I<times>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:45
#, no-wrap
msgid ""
"B<int utimes(const char *>I<filename>B<, const struct timeval "
">I<times>B<[2]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:57
msgid ""
"The B<utime>()  system call changes the access and modification times of the "
"inode specified by I<filename> to the I<actime> and I<modtime> fields of "
"I<times> respectively."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:62
msgid ""
"If I<times> is NULL, then the access and modification times of the file are "
"set to the current time."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:69
msgid ""
"Changing timestamps is permitted when: either the process has appropriate "
"privileges, or the effective user ID equals the user ID of the file, or "
"I<times> is NULL and the process has write permission for the file."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:73
msgid "The I<utimbuf> structure is:"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:80
#, no-wrap
msgid ""
"struct utimbuf {\n"
"    time_t actime;       /* access time */\n"
"    time_t modtime;      /* modification time */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:87
msgid ""
"The B<utime>()  system call allows specification of timestamps with a "
"resolution of 1 second."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:100
msgid ""
"The B<utimes>()  system call is similar, but the I<times> argument refers to "
"an array rather than a structure.  The elements of this array are I<timeval> "
"structures, which allow a precision of 1 microsecond for specifying "
"timestamps.  The I<timeval> structure is:"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:107
#, no-wrap
msgid ""
"struct timeval {\n"
"    long tv_sec;        /* seconds */\n"
"    long tv_usec;       /* microseconds */\n"
"};\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:120
msgid ""
"I<times>[0] specifies the new access time, and I<times>[1] specifies the new "
"modification time.  If I<times> is NULL, then analogously to B<utime>(), the "
"access and modification times of the file are set to the current time."
msgstr ""

#. type: TP
#: build/C/man2/utime.2:126 build/C/man2/utime.2:133 build/C/man2/utimensat.2:235
#, no-wrap
msgid "B<EACCES>"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:133
msgid ""
"Search permission is denied for one of the directories in the path prefix of "
"I<path> (see also B<path_resolution>(7))."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:145
msgid ""
"I<times> is NULL, the caller's effective user ID does not match the owner of "
"the file, the caller does not have write access to the file, and the caller "
"is not privileged (Linux: does not have either the B<CAP_DAC_OVERRIDE> or "
"the B<CAP_FOWNER> capability)."
msgstr ""

#. type: TP
#: build/C/man2/utime.2:145 build/C/man2/utimensat.2:344
#, no-wrap
msgid "B<ENOENT>"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:149
msgid "I<filename> does not exist."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:158
msgid ""
"I<times> is not NULL, the caller's effective UID does not match the owner of "
"the file, and the caller is not privileged (Linux: does not have the "
"B<CAP_FOWNER> capability)."
msgstr ""

#. type: TP
#: build/C/man2/utime.2:158 build/C/man2/utimensat.2:405
#, no-wrap
msgid "B<EROFS>"
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:162
msgid "I<path> resides on a read-only file system."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:168
msgid "B<utime>(): SVr4, POSIX.1-2001.  POSIX.1-2008 marks B<utime>()  as obsolete."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:171
msgid "B<utimes>(): 4.3BSD, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:175
msgid ""
"Linux does not allow changing the timestamps on an immutable file, or "
"setting the timestamps to something other than the current time on an "
"append-only file."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:181
msgid ""
"In libc4 and libc5, B<utimes>()  is just a wrapper for B<utime>()  and hence "
"does not allow a subsecond resolution."
msgstr ""

#. type: Plain text
#: build/C/man2/utime.2:188
msgid ""
"B<chattr>(1), B<futimesat>(2), B<stat>(2), B<utimensat>(2), B<futimens>(3), "
"B<futimes>(3)"
msgstr ""

#. type: TH
#: build/C/man2/utimensat.2:26
#, no-wrap
msgid "UTIMENSAT"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:29
msgid "utimensat, futimens - change file timestamps with nanosecond precision"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:33
#, no-wrap
msgid ""
"B<#include E<lt>fcntl.hE<gt> /* Definition of AT_* constants */>\n"
"B<#include E<lt>sys/stat.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:36
#, no-wrap
msgid ""
"B<int utimensat(int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
"B<              const struct timespec >I<times>B<[2], int >I<flags>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:38
#, no-wrap
msgid "B<int futimens(int >I<fd>B<, const struct timespec >I<times>B<[2]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:48
msgid "B<utimensat>():"
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:49 build/C/man2/utimensat.2:59
#, no-wrap
msgid "Since glibc 2.10:"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:52 build/C/man2/utimensat.2:62
msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:52 build/C/man2/utimensat.2:62
#, no-wrap
msgid "Before glibc 2.10:"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:55
msgid "_ATFILE_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:58
msgid "B<futimens>():"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:79
msgid ""
"B<utimensat>()  and B<futimens>()  update the timestamps of a file with "
"nanosecond precision.  This contrasts with the historical B<utime>(2)  and "
"B<utimes>(2), which permit only second and microsecond precision, "
"respectively, when setting file timestamps."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:89
msgid ""
"With B<utimensat>()  the file is specified via the pathname given in "
"I<pathname>.  With B<futimens>()  the file whose timestamps are to be "
"updated is specified via an open file descriptor, I<fd>."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:101
msgid ""
"For both calls, the new file timestamps are specified in the array I<times>: "
"I<times>[0] specifies the new \"last access time\" (I<atime>); I<times>[1] "
"specifies the new \"last modification time\" (I<mtime>).  Each of the "
"elements of I<times> specifies a time as the number of seconds and "
"nanoseconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).  This "
"information is conveyed in a structure of the following form:"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:113
msgid ""
"Updated file timestamps are set to the greatest value supported by the file "
"system that is not greater than the specified time."
msgstr ""

#.  2.6.22 was broken: it is not ignored
#. type: Plain text
#: build/C/man2/utimensat.2:132
msgid ""
"If the I<tv_nsec> field of one of the I<timespec> structures has the special "
"value B<UTIME_NOW>, then the corresponding file timestamp is set to the "
"current time.  If the I<tv_nsec> field of one of the I<timespec> structures "
"has the special value B<UTIME_OMIT>, then the corresponding file timestamp "
"is left unchanged.  In both of these cases, the value of the corresponding "
"I<tv_sec> field is ignored."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:137
msgid "If I<times> is NULL, then both timestamps are set to the current time."
msgstr ""

#. type: SS
#: build/C/man2/utimensat.2:137
#, no-wrap
msgid "Permissions requirements"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:145
msgid ""
"To set both file timestamps to the current time (i.e., I<times> is NULL, or "
"both I<tv_nsec> fields specify B<UTIME_NOW>), either:"
msgstr ""

#. type: IP
#: build/C/man2/utimensat.2:145
#, no-wrap
msgid "1."
msgstr ""

#.  2.6.22 was broken here -- for futimens() the check is
#.  based on whether or not the file descriptor is writable,
#.  not on whether the caller's effective UID has write
#.  permission for the file referred to by the descriptor.
#. type: Plain text
#: build/C/man2/utimensat.2:151
msgid "the caller must have write access to the file;"
msgstr ""

#. type: IP
#: build/C/man2/utimensat.2:151
#, no-wrap
msgid "2."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:153
msgid "the caller's effective user ID must match the owner of the file; or"
msgstr ""

#. type: IP
#: build/C/man2/utimensat.2:153
#, no-wrap
msgid "3."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:155
msgid "the caller must have appropriate privileges."
msgstr ""

#.  2.6.22 was broken here:
#.  both must something other than *either* UTIME_OMIT *or* UTIME_NOW.
#. type: Plain text
#: build/C/man2/utimensat.2:170
msgid ""
"To make any change other than setting both timestamps to the current time "
"(i.e., I<times> is not NULL, and both I<tv_nsec> fields are not B<UTIME_NOW> "
"and both I<tv_nsec> fields are not B<UTIME_OMIT>), either condition 2 or 3 "
"above must apply."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:180
msgid ""
"If both I<tv_nsec> fields are specified as B<UTIME_OMIT>, then no file "
"ownership or permission checks are performed, and the file timestamps are "
"not modified, but other error conditions may still be detected."
msgstr ""

#. type: SS
#: build/C/man2/utimensat.2:180
#, no-wrap
msgid "utimensat() specifics"
msgstr ""

#.  FIXME . Say something about O_SEARCH?  (But it's not in current
#.  glibc (Mar 08), or kernel 2.6.25.)
#. type: Plain text
#: build/C/man2/utimensat.2:195
msgid ""
"If I<pathname> is relative, then by default it is interpreted relative to "
"the directory referred to by the open file descriptor, I<dirfd> (rather than "
"relative to the current working directory of the calling process, as is done "
"by B<utimes>(2)  for a relative pathname).  See B<openat>(2)  for an "
"explanation of why this can be useful."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:207
msgid ""
"If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
"then I<pathname> is interpreted relative to the current working directory of "
"the calling process (like B<utimes>(2))."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:213
msgid "If I<pathname> is absolute, then I<dirfd> is ignored."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:219
msgid ""
"The I<flags> field is a bit mask that may be 0, or include the following "
"constant, defined in I<E<lt>fcntl.hE<gt>>:"
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:219
#, no-wrap
msgid "B<AT_SYMLINK_NOFOLLOW>"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:225
msgid ""
"If I<pathname> specifies a symbolic link, then update the timestamps of the "
"link, rather than the file to which it refers."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:234
msgid ""
"On success, B<utimensat>()  and B<futimens>()  return 0.  On error, -1 is "
"returned and I<errno> is set to indicate the error."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:244
msgid "I<times> is NULL, or both I<tv_nsec> values are B<UTIME_NOW>, and:"
msgstr ""

#.  But Linux 2.6.22 was broken here.
#.  Traditionally, utime()/utimes() gives the error EACCES for the case
#.  where the timestamp pointer argument is NULL (i.e., set both timestamps
#.  to the current time), and the file is owned by a user other than the
#.  effective UID of the caller, and the file is not writable by the
#.  effective UID of the program.  utimensat() also gives this error in the
#.  same case.  However, in the same circumstances, when utimensat() is
#.  given a 'times' array in which both tv_nsec fields are UTIME_NOW, which
#.  provides equivalent functionality to specifying 'times' as NULL, the
#.  call succeeds.  It should fail with the error EACCES in this case.
#
#.  POSIX.1-2008 has the following:
#.  .TP
#.  .B EACCES
#.  .RB ( utimensat ())
#.  .I fd
#.  was not opened with
#.  .B O_SEARCH
#.  and the permissions of the directory to which
#.  .I fd
#.  refers do not allow searches.
#. type: Plain text
#: build/C/man2/utimensat.2:277
msgid ""
"the effective user ID of the caller does not match the owner of the file, "
"the caller does not have write access to the file, and the caller is not "
"privileged (Linux: does not have either the B<CAP_FOWNER> or the "
"B<CAP_DAC_OVERRIDE> capability); or,"
msgstr ""

#.  EXT2_IMMUTABLE_FL and similar flags for other file systems.
#. type: Plain text
#: build/C/man2/utimensat.2:281
msgid "the file is marked immutable (see B<chattr>(1))."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:288
msgid "(B<futimens>())  I<fd> is not a valid file descriptor."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:297
msgid ""
"(B<utimensat>())  I<pathname> is a relative pathname, but I<dirfd> is "
"neither B<AT_FDCWD> nor a valid file descriptor."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:307
msgid ""
"I<times> pointed to an invalid address; or, I<dirfd> was B<AT_FDCWD>, and "
"I<pathname> is NULL or an invalid address."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:311
msgid "Invalid value in I<flags>."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:322
msgid ""
"Invalid value in one of the I<tv_nsec> fields (value outside range 0 to "
"999,999,999, and not B<UTIME_NOW> or B<UTIME_OMIT>); or an invalid value in "
"one of the I<tv_sec> fields."
msgstr ""

#.  SUSv4 does not specify this error.
#. type: Plain text
#: build/C/man2/utimensat.2:334
msgid ""
"I<pathname> is NULL, I<dirfd> is not B<AT_FDCWD>, and I<flags> contains "
"B<AT_SYMLINK_NOFOLLOW>."
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:334
#, no-wrap
msgid "B<ELOOP>"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:339
msgid ""
"(B<utimensat>())  Too many symbolic links were encountered in resolving "
"I<pathname>."
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:339
#, no-wrap
msgid "B<ENAMETOOLONG>"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:344
msgid "(B<utimensat>())  I<pathname> is too long."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:353
msgid ""
"(B<utimensat>())  A component of I<pathname> does not refer to an existing "
"directory or file, or I<pathname> is an empty string."
msgstr ""

#. type: TP
#: build/C/man2/utimensat.2:353
#, no-wrap
msgid "B<ENOTDIR>"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:365
msgid ""
"(B<utimensat>())  I<pathname> is a relative pathname, but I<dirfd> is "
"neither B<AT_FDCWD> nor a file descriptor referring to a directory; or, one "
"of the prefix components of I<pathname> is not a directory."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:382
msgid ""
"The caller attempted to change one or both timestamps to a value other than "
"the current time, or to change one of the timestamps to the current time "
"while leaving the other timestamp unchanged, (i.e., I<times> is not NULL, "
"both I<tv_nsec> fields are not B<UTIME_NOW>, and both I<tv_nsec> fields are "
"not B<UTIME_OMIT>)  and:"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:390
msgid ""
"the caller's effective user ID does not match the owner of file, and the "
"caller is not privileged (Linux: does not have the B<CAP_FOWNER> "
"capability); or,"
msgstr ""

#.  Linux 2.6.22 was broken here:
#.  it was not consistent with the old utimes() implementation,
#.  since the case when both tv_nsec fields are UTIME_NOW, was not
#.  treated like the (times == NULL) case.
#.  EXT2_IMMUTABLE_FL EXT_APPPEND_FL and similar flags for
#.  other file systems.
#
#.  Why the inconsistency (which is described under NOTES) between
#.  EACCES and EPERM, where only EPERM tests for append-only.
#.  (This was also so for the older utimes() implementation.)
#. type: Plain text
#: build/C/man2/utimensat.2:403
msgid "the file is marked append-only or immutable (see B<chattr>(1))."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:408
msgid "The file is on a read-only file system."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:413
msgid ""
"(B<utimensat>())  Search permission is denied for one of the prefix "
"components of I<pathname>."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:417
msgid ""
"B<utimensat>()  was added to Linux in kernel 2.6.22; glibc support was added "
"with version 2.6."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:421
msgid "Support for B<futimens>()  first appeared in glibc 2.6."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:426
msgid "B<futimens>()  and B<utimensat>()  are specified in POSIX.1-2008."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:430
msgid "B<utimensat>()  obsoletes B<futimesat>(2)."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:439
msgid ""
"On Linux, timestamps cannot be changed for a file marked immutable, and the "
"only change permitted for files marked append-only is to set the timestamps "
"to the current time.  (This is consistent with the historical behavior of "
"B<utime>(2)  and B<utimes>(2)  on Linux.)"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:456
msgid ""
"On Linux, B<futimens>()  is a library function implemented on top of the "
"B<utimensat>()  system call.  To support this, the Linux B<utimensat>()  "
"system call implements a nonstandard feature: if I<pathname> is NULL, then "
"the call modifies the timestamps of the file referred to by the file "
"descriptor I<dirfd> (which may refer to any type of file).  Using this "
"feature, the call I<futimens(fd,\\ times)> is implemented as:"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:459
#, no-wrap
msgid "    utimensat(fd, NULL, times, 0);\n"
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:468
msgid ""
"Several bugs afflict B<utimensat>()  and B<futimens>()  on kernels before "
"2.6.26.  These bugs are either nonconformances with the POSIX.1 draft "
"specification or inconsistencies with historical Linux behavior."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:483
msgid ""
"POSIX.1 specifies that if one of the I<tv_nsec> fields has the value "
"B<UTIME_NOW> or B<UTIME_OMIT>, then the value of the corresponding I<tv_sec> "
"field should be ignored.  Instead, the value of the I<tv_sec> field is "
"required to be 0 (or the error B<EINVAL> results)."
msgstr ""

#.  Below, the long description of the errors from the previous bullet
#.  point (abridged because it's too much detail for a man page).
#.  .IP *
#.  If one of the
#.  .I tv_nsec
#.  fields is
#.  .BR UTIME_OMIT
#.  and the other is
#.  .BR UTIME_NOW ,
#.  then the error
#.  .B EPERM
#.  should occur if the process's effective user ID does not match
#.  the file owner and the process is not privileged.
#.  Instead, the call successfully changes one of the timestamps.
#.  .IP *
#.  If file is not writable by the effective user ID of the process and
#.  the process's effective user ID does not match the file owner and
#.  the process is not privileged,
#.  and
#.  .I times
#.  is NULL, then the error
#.  .B EACCES
#.  results.
#.  This error should also occur if
#.  .I times
#.  points to an array of structures in which both
#.  .I tv_nsec
#.  fields are
#.  .BR UTIME_NOW .
#.  Instead the call succeeds.
#.  .IP *
#.  If a file is marked as append-only (see
#.  .BR chattr (1)),
#.  then Linux traditionally
#.  (i.e.,
#.  .BR utime (2),
#.  .BR utimes (2)),
#.  permits a NULL
#.  .I times
#.  argument to be used in order to update both timestamps to the current time.
#.  For consistency,
#.  .BR utimensat ()
#.  and
#.  .BR futimens ()
#.  should also produce the same result when given a
#.  .I times
#.  argument that points to an array of structures in which both
#.  .I tv_nsec
#.  fields are
#.  .BR UTIME_NOW .
#.  Instead, the call fails with the error
#.  .BR EPERM .
#.  .IP *
#.  If a file is marked as immutable (see
#.  .BR chattr (1)),
#.  then Linux traditionally
#.  (i.e.,
#.  .BR utime (2),
#.  .BR utimes (2)),
#.  gives an
#.  .B EACCES
#.  error if
#.  .I times
#.  is NULL.
#.  For consistency,
#.  .BR utimensat ()
#.  and
#.  .BR futimens ()
#.  should also produce the same result when given a
#.  .I times
#.  that points to an array of structures in which both
#.  .I tv_nsec
#.  fields are
#.  .BR UTIME_NOW .
#.  Instead, the call fails with the error
#.  .BR EPERM .
#. type: Plain text
#: build/C/man2/utimensat.2:585
msgid ""
"Various bugs mean that for the purposes of permission checking, the case "
"where both I<tv_nsec> fields are set to B<UTIME_NOW> isn't always treated "
"the same as specifying I<times> as NULL, and the case where one I<tv_nsec> "
"value is B<UTIME_NOW> and the other is B<UTIME_OMIT> isn't treated the same "
"as specifying I<times> as a pointer to an array of structures containing "
"arbitrary time values.  As a result, in some cases: a) file timestamps can "
"be updated by a process that shouldn't have permission to perform updates; "
"b) file timestamps can't be updated by a process that should have permission "
"to perform updates; and c) the wrong I<errno> value is returned in case of "
"an error."
msgstr ""

#.  This means that a process with a file descriptor that allows
#.  writing could change the timestamps of a file for which it
#.  does not have write permission;
#.  conversely, a process with a read-only file descriptor won't
#.  be able to update the timestamps of a file,
#.  even if it has write permission on the file.
#. type: Plain text
#: build/C/man2/utimensat.2:606
msgid ""
"POSIX.1 says that a process that has I<write access to the file> can make a "
"call with I<times> as NULL, or with I<times> pointing to an array of "
"structures in which both I<tv_nsec> fields are B<UTIME_NOW>, in order to "
"update both timestamps to the current time.  However, B<futimens>()  instead "
"checks whether the I<access mode of the file descriptor allows writing>."
msgstr ""

#. type: Plain text
#: build/C/man2/utimensat.2:615
msgid ""
"B<chattr>(1), B<futimesat>(2), B<openat>(2), B<stat>(2), B<utimes>(2), "
"B<futimes>(3), B<path_resolution>(7), B<symlink>(7)"
msgstr ""

#. type: TH
#: build/C/man8/zdump.8:3
#, no-wrap
msgid "ZDUMP"
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:6
msgid "zdump - timezone dumper"
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:13
msgid "B<zdump> [ B<-v> ] [ B<-c> cutoffyear ] [ zonename ... ]"
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:18
msgid ""
"I<Zdump> prints the current time in each I<zonename> named on the command "
"line."
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:20 build/C/man8/zic.8:48
msgid "These options are available:"
msgstr ""

#. type: TP
#: build/C/man8/zdump.8:20 build/C/man8/zic.8:74
#, no-wrap
msgid "B<-v>"
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:36
msgid ""
"For each I<zonename> on the command line, print the time at the lowest "
"possible time value, the time one day after the lowest possible time value, "
"the times both one second before and exactly at each detected time "
"discontinuity, the time at one day less than the highest possible time "
"value, and the time at the highest possible time value.  Each line ends with "
"B<isdst=1> if the given time is Daylight Saving Time or B<isdst=0> "
"otherwise."
msgstr ""

#. type: TP
#: build/C/man8/zdump.8:36
#, no-wrap
msgid "B<-c >I<cutoffyear>"
msgstr ""

#. type: Plain text
#: build/C/man8/zdump.8:39
msgid "Cut off the verbose output near the start of the given year."
msgstr ""

#.  @(#)zdump.8	7.3
#. type: Plain text
#: build/C/man8/zdump.8:43
msgid "B<tzfile>(5), B<zic>(8)"
msgstr ""

#. type: TH
#: build/C/man8/zic.8:3
#, no-wrap
msgid "ZIC"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:6
msgid "zic - timezone compiler"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:30
msgid ""
"B<zic> [ B<-v> ] [ B<-d> I<directory> ] [ B<-l> I<localtime> ] [ B<-p> "
"I<posixrules> ] [ B<-L> I<leapsecondfilename> ] [ B<-s> ] [ B<-y> I<command> "
"] [ I<filename> \\&... ]"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:46
msgid ""
"I<Zic> reads text from the file(s) named on the command line and creates the "
"time conversion information files specified in this input.  If a I<filename> "
"is B<->, the standard input is read."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:48
#, no-wrap
msgid "B<-d >I<directory>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:52
msgid ""
"Create time conversion information files in the named directory rather than "
"in the standard directory named below."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:52
#, no-wrap
msgid "B<-l >I<timezone>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:57
msgid ""
"Use the given timezone as local time.  I<Zic> will act as if the input "
"contained a link line of the form"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:60
msgid "Link\tI<timezone>\t\tlocaltime"
msgstr ""

#. type: TP
#: build/C/man8/zic.8:60
#, no-wrap
msgid "B<-p >I<timezone>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:66
msgid ""
"Use the given timezone's rules when handling POSIX-format timezone "
"environment variables.  I<Zic> will act as if the input contained a link "
"line of the form"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:69
msgid "Link\tI<timezone>\t\tposixrules"
msgstr ""

#. type: TP
#: build/C/man8/zic.8:69
#, no-wrap
msgid "B<-L >I<leapsecondfilename>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:74
msgid ""
"Read leap second information from the file with the given name.  If this "
"option is not used, no leap second information appears in output files."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:80
msgid ""
"Complain if a year that appears in a data file is outside the range of years "
"representable by B<time>(2)  values."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:80
#, no-wrap
msgid "B<-s>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:85
msgid ""
"Limit time values stored in output files to values that are the same whether "
"they're taken to be signed or unsigned.  You can use this option to generate "
"SVVS-compatible files."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:85
#, no-wrap
msgid "B<-y >I<command>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:92
msgid ""
"Use the given I<command> rather than B<yearistype> when checking year types "
"(see below)."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:103
msgid ""
"Input lines are made up of fields.  Fields are separated from one another by "
"any number of white space characters.  Leading and trailing white space on "
"input lines is ignored.  An unquoted sharp character (#) in the input "
"introduces a comment which extends to the end of the line the sharp "
"character appears on.  White space characters and sharp characters may be "
"enclosed in double quotes (\") if they're to be used as part of a field.  "
"Any line that is blank (after comment stripping) is ignored.  Nonblank lines "
"are expected to be of one of three types: rule lines, zone lines, and link "
"lines."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:105
msgid "A rule line has the form"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:107
#, no-wrap
msgid ""
"\\w'Rule\\0\\0'u +\\w'NAME\\0\\0'u +\\w'FROM\\0\\0'u +\\w'1973\\0\\0'u "
"+\\w'TYPE\\0\\0'u +\\w'Apr\\0\\0'u +\\w'lastSun\\0\\0'u +\\w'2:00\\0\\0'u "
"+\\w'SAVE\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:110
#, no-wrap
msgid "Rule\tNAME\tFROM\tTO\tTYPE\tIN\tON\tAT\tSAVE\tLETTER/S\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:112 build/C/man8/zic.8:267 build/C/man8/zic.8:338 build/C/man8/zic.8:363
#, no-wrap
msgid "For example:\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:115
#, no-wrap
msgid "Rule\tUS\t1967\t1973\t-\tApr\tlastSun\t2:00\t1:00\tD\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:118
msgid "The fields that make up a rule line are:"
msgstr ""

#. type: TP
#: build/C/man8/zic.8:118 build/C/man8/zic.8:273
#, no-wrap
msgid "B<NAME>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:121
msgid "Gives the (arbitrary) name of the set of rules this rule is part of."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:121
#, no-wrap
msgid "B<FROM>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:134
msgid ""
"Gives the first year in which the rule applies.  Any integer year can be "
"supplied; the Gregorian calendar is assumed.  The word I<minimum> (or an "
"abbreviation) means the minimum year representable as an integer.  The word "
"I<maximum> (or an abbreviation) means the maximum year representable as an "
"integer.  Rules can describe times that are not representable as time "
"values, with the unrepresentable times ignored; this allows rules to be "
"portable among hosts with differing time value types."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:134
#, no-wrap
msgid "B<TO>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:148
msgid ""
"Gives the final year in which the rule applies.  In addition to I<minimum> "
"and I<maximum> (as above), the word I<only> (or an abbreviation)  may be "
"used to repeat the value of the B<FROM> field."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:148
#, no-wrap
msgid "B<TYPE>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:165
msgid ""
"Gives the type of year in which the rule applies.  If B<TYPE> is B<-> then "
"the rule applies in all years between B<FROM> and B<TO> inclusive.  If "
"B<TYPE> is something else, then I<zic> executes the command"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:167
msgid "B<yearistype> I<year> I<type>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:171
msgid ""
"to check the type of a year: an exit status of zero is taken to mean that "
"the year is of the given type; an exit status of one is taken to mean that "
"the year is not of the given type."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:171
#, no-wrap
msgid "B<IN>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:175
msgid ""
"Names the month in which the rule takes effect.  Month names may be "
"abbreviated."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:175
#, no-wrap
msgid "B<ON>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:179
msgid "Gives the day on which the rule takes effect.  Recognized forms include:"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:182
#, no-wrap
msgid "\\w'SunE<lt>=25\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:188
#, no-wrap
msgid ""
"5\tthe fifth of the month\n"
"lastSun\tthe last Sunday in the month\n"
"lastMon\tthe last Monday in the month\n"
"SunE<gt>=8\tfirst Sunday on or after the eighth\n"
"SunE<lt>=25\tlast Sunday on or before the 25th\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:195
msgid ""
"Names of days of the week may be abbreviated or spelled out in full.  Note "
"that there must be no spaces within the B<ON> field."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:195
#, no-wrap
msgid "B<AT>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:199
msgid ""
"Gives the time of day at which the rule takes effect.  Recognized forms "
"include:"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:202
#, no-wrap
msgid "\\w'1:28:13\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:208
#, no-wrap
msgid ""
"2\ttime in hours\n"
"2:00\ttime in hours and minutes\n"
"15:00\t24-hour format time (for times after noon)\n"
"1:28:14\ttime in hours, minutes, and seconds\n"
"-\tequivalent to 0\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:230
msgid ""
"where hour 0 is midnight at the start of the day, and hour 24 is midnight at "
"the end of the day.  Any of these forms may be followed by the letter I<w> "
"if the given time is local E<.q \"wall clock\"> time, I<s> if the given time "
"is local E<.q standard> time, or I<u> (or I<g> or I<z>)  if the given time "
"is universal time; in the absence of an indicator, wall clock time is "
"assumed."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:230
#, no-wrap
msgid "B<SAVE>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:242
msgid ""
"Gives the amount of time to be added to local standard time when the rule is "
"in effect.  This field has the same format as the B<AT> field (although, of "
"course, the I<w> and I<s> suffixes are not used)."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:242
#, no-wrap
msgid "B<LETTER/S>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:258
msgid ""
"Gives the E<.q \"variable part\"> (for example, the E<.q S> or E<.q D> in "
"E<.q EST> or E<.q EDT )> of timezone abbreviations to be used when this rule "
"is in effect.  If this field is B<->, the variable part is null."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:260
msgid "A zone line has the form"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:263
#, no-wrap
msgid ""
"\\w'Zone\\0\\0'u +\\w'Australia/Adelaide\\0\\0'u +\\w'UTCOFF\\0\\0'u "
"+\\w'RULES/SAVE\\0\\0'u +\\w'FORMAT\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:265
#, no-wrap
msgid "Zone\tNAME\tUTCOFF\tRULES/SAVE\tFORMAT\t[UNTIL]\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:270
#, no-wrap
msgid "Zone\tAustralia/Adelaide\t9:30\tAus\tCST\t1971 Oct 31 2:00\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:273
msgid "The fields that make up a zone line are:"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:278
msgid ""
"The name of the timezone.  This is the name used in creating the time "
"conversion information file for the zone."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:278
#, no-wrap
msgid "B<UTCOFF>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:287
msgid ""
"The amount of time to add to UTC to get standard time in this zone.  This "
"field has the same format as the B<AT> and B<SAVE> fields of rule lines; "
"begin the field with a minus sign if time must be subtracted from UTC."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:287
#, no-wrap
msgid "B<RULES/SAVE>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:294
msgid ""
"The name of the rule(s) that apply in the timezone or, alternately, an "
"amount of time to add to local standard time.  If this field is B<-> then "
"standard time always applies in the timezone."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:294
#, no-wrap
msgid "B<FORMAT>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:305
msgid ""
"The format for timezone abbreviations in this timezone.  The pair of "
"characters B<%s> is used to show where the E<.q \"variable part\"> of the "
"timezone abbreviation goes.  Alternately, a slash (/)  separates standard "
"and daylight abbreviations."
msgstr ""

#. type: TP
#: build/C/man8/zic.8:305
#, no-wrap
msgid "B<UNTIL>"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:315
msgid ""
"The time at which the UTC offset or the rule(s) change for a location.  It "
"is specified as a year, a month, a day, and a time of day.  If this is "
"specified, the timezone information is generated from the given UTC offset "
"and rule change until the time specified.  The month, day, and time of day "
"have the same format as the IN, ON, and AT columns of a rule; trailing "
"columns can be omitted, and default to the earliest possible value for the "
"missing columns."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:329
msgid ""
"The next line must be a E<.q continuation> line; this has the same form as a "
"zone line except that the string E<.q Zone> and the name are omitted, as the "
"continuation line will place information starting at the time specified as "
"the B<UNTIL> field in the previous line in the file used by the previous "
"line.  Continuation lines may contain an B<UNTIL> field, just as zone lines "
"do, indicating that the next line is a further continuation."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:331
msgid "A link line has the form"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:334
#, no-wrap
msgid "\\w'Link\\0\\0'u +\\w'Europe/Istanbul\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:336
#, no-wrap
msgid "Link\tLINK-FROM\tLINK-TO\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:341
#, no-wrap
msgid "Link\tEurope/Istanbul\tAsia/Istanbul\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:351
msgid ""
"The B<LINK-FROM> field should appear as the B<NAME> field in some zone line; "
"the B<LINK-TO> field is used as an alternate name for that zone."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:354
msgid "Except for continuation lines, lines may appear in any order in the input."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:356
msgid "Lines in the file that describes leap seconds have the following form:"
msgstr ""

#. type: ta
#: build/C/man8/zic.8:358
#, no-wrap
msgid ""
"\\w'Leap\\0\\0'u +\\w'YEAR\\0\\0'u +\\w'MONTH\\0\\0'u +\\w'DAY\\0\\0'u "
"+\\w'HH:MM:SS\\0\\0'u +\\w'CORR\\0\\0'u"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:361
#, no-wrap
msgid "Leap\tYEAR\tMONTH\tDAY\tHH:MM:SS\tCORR\tR/S\n"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:366
#, no-wrap
msgid "Leap\t1974\tDec\t31\t23:59:60\t+\tS\n"
msgstr ""

#.  There's no need to document the following, since it's impossible for more
#.  than one leap second to be inserted or deleted at a time.
#.  The C Standard is in error in suggesting the possibility.
#.  See Terry J Quinn, The BIPM and the accurate measure of time,
#.  Proc IEEE 79, 7 (July 1991), 894-905.
#. 	or
#. 	.q ++
#. 	if two seconds were added
#. 	or
#. 	.q --
#. 	if two seconds were skipped.
#. type: Plain text
#: build/C/man8/zic.8:406
msgid ""
"The B<YEAR>, B<MONTH>, B<DAY>, and B<HH:MM:SS> fields tell when the leap "
"second happened.  The B<CORR> field should be E<.q +> if a second was added "
"or E<.q -> if a second was skipped.  The B<R/S> field should be (an "
"abbreviation of)  E<.q Stationary> if the leap second time given by the "
"other fields should be interpreted as UTC or (an abbreviation of)  E<.q "
"Rolling> if the leap second time given by the other fields should be "
"interpreted as local wall clock time."
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:408
msgid "/usr/local/etc/zoneinfo\tstandard directory used for created files"
msgstr ""

#. type: Plain text
#: build/C/man8/zic.8:414
msgid ""
"For areas with more than two types of local time, you may need to use local "
"standard time in the B<AT> field of the earliest transition time's rule to "
"ensure that the earliest transition time recorded in the compiled file is "
"correct."
msgstr ""

#.  @(#)zic.8	7.19
#. type: Plain text
#: build/C/man8/zic.8:418
msgid "B<tzfile>(5), B<zdump>(8)"
msgstr ""
