#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: man-pages-l10n VERSION\n"
"POT-Creation-Date: 2014-07-17 17:53+0900\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: man-pages/man2/clock_getres.2:30
#, no-wrap
msgid "CLOCK_GETRES"
msgstr ""

#. type: TH
#: man-pages/man2/clock_getres.2:30
#, no-wrap
msgid "2013-12-28"
msgstr ""

#. type: TH
#: man-pages/man2/clock_getres.2:30
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:31
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:33
msgid "clock_getres, clock_gettime, clock_settime - clock and time functions"
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:33
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:35
msgid "B<#include E<lt>time.hE<gt>>"
msgstr ""

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

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

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

#. type: Plain text
#: man-pages/man2/clock_getres.2:43
msgid "Link with I<-lrt> (only for glibc versions before 2.17)."
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:47
msgid ""
"Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:53
msgid "B<clock_getres>(), B<clock_gettime>(), B<clock_settime>():"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:55
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 199309L"
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:57
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:76
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
#: man-pages/man2/clock_getres.2:83
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
#: man-pages/man2/clock_getres.2:92
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
#: man-pages/man2/clock_getres.2:99
#, no-wrap
msgid ""
"struct timespec {\n"
"    time_t   tv_sec;        /* seconds */\n"
"    long     tv_nsec;       /* nanoseconds */\n"
"};\n"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:107
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
#: man-pages/man2/clock_getres.2:114
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
#: man-pages/man2/clock_getres.2:118
msgid ""
"More clocks may be implemented.  The interpretation of the corresponding "
"time values and the effect on timers is unspecified."
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:121
msgid ""
"Sufficiently recent versions of glibc and the Linux kernel support the "
"following clocks:"
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:121
#, no-wrap
msgid "B<CLOCK_REALTIME>"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:130
msgid ""
"System-wide clock that measures real (i.e., wall-clock) time.  Setting this "
"clock requires appropriate privileges.  This clock is affected by "
"discontinuous jumps in the system time (e.g., if the system administrator "
"manually changes the clock), and by the incremental adjustments performed by "
"B<adjtime>(3)  and NTP."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:130
#, no-wrap
msgid "B<CLOCK_REALTIME_COARSE> (since Linux 2.6.32; Linux-specific)"
msgstr ""

#.  Added in commit da15cfdae03351c689736f8d142618592e3cebc3
#. type: Plain text
#: man-pages/man2/clock_getres.2:136
msgid ""
"A faster but less precise version of B<CLOCK_REALTIME>.  Use when you need "
"very fast, but not fine-grained timestamps."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:137
#, no-wrap
msgid "B<CLOCK_MONOTONIC>"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:146
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>(3)  and NTP."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:146
#, no-wrap
msgid "B<CLOCK_MONOTONIC_COARSE> (since Linux 2.6.32; Linux-specific)"
msgstr ""

#.  Added in commit da15cfdae03351c689736f8d142618592e3cebc3
#. type: Plain text
#: man-pages/man2/clock_getres.2:152
msgid ""
"A faster but less precise version of B<CLOCK_MONOTONIC>.  Use when you need "
"very fast, but not fine-grained timestamps."
msgstr ""

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

#.  Added in commit 2d42244ae71d6c7b0884b5664cf2eda30fb2ae68, John Stultz
#. type: Plain text
#: man-pages/man2/clock_getres.2:161
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>(3)."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:161
#, no-wrap
msgid "B<CLOCK_BOOTTIME> (since Linux 2.6.39; Linux-specific)"
msgstr ""

#.  commit 7fdd7f89006dd5a4c702fa0ce0c272345fa44ae0
#.  commit 70a08cca1227dc31c784ec930099a4417a06e7d0
#. type: Plain text
#: man-pages/man2/clock_getres.2:173
msgid ""
"Identical to B<CLOCK_MONOTONIC>, except it also includes any time that the "
"system is suspended.  This allows applications to get a suspend-aware "
"monotonic clock without having to deal with the complications of "
"B<CLOCK_REALTIME>, which may have discontinuities if the time is changed "
"using B<settimeofday>(2)."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:173
#, no-wrap
msgid "B<CLOCK_PROCESS_CPUTIME_ID> (since Linux 2.6.12)"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:177
msgid ""
"Per-process CPU-time clock (measures CPU time consumed by all threads in the "
"process)."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:177
#, no-wrap
msgid "B<CLOCK_THREAD_CPUTIME_ID> (since Linux 2.6.12)"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:180
msgid "Thread-specific CPU-time clock."
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:180
#, no-wrap
msgid "RETURN VALUE"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:188
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: SH
#: man-pages/man2/clock_getres.2:188
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:189
#, no-wrap
msgid "B<EFAULT>"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:193
msgid "I<tp> points outside the accessible address space."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:193
#, no-wrap
msgid "B<EINVAL>"
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
#: man-pages/man2/clock_getres.2:201
msgid "The I<clk_id> specified is not supported on this system."
msgstr ""

#. type: TP
#: man-pages/man2/clock_getres.2:201
#, no-wrap
msgid "B<EPERM>"
msgstr ""

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

#. type: SH
#: man-pages/man2/clock_getres.2:205
#, no-wrap
msgid "VERSIONS"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:207
msgid "These system calls first appeared in Linux 2.6."
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:207
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:209
msgid "SUSv2, POSIX.1-2001."
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:209
#, no-wrap
msgid "AVAILABILITY"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:224
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: SH
#: man-pages/man2/clock_getres.2:224
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: SS
#: man-pages/man2/clock_getres.2:225
#, no-wrap
msgid "Historical note for SMP systems"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:237
msgid ""
"Before Linux added kernel support for B<CLOCK_PROCESS_CPUTIME_ID> and "
"B<CLOCK_THREAD_CPUTIME_ID>, glibc implemented these clocks on many platforms "
"using timer registers 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
#: man-pages/man2/clock_getres.2:248
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 be useful only if it can be ensured that a process "
"stays on a certain CPU."
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:257
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 ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:266
msgid ""
"Since glibc 2.4, the wrapper functions for the system calls described in "
"this page avoid the abovementioned problems by employing the kernel "
"implementation of B<CLOCK_PROCESS_CPUTIME_ID> and "
"B<CLOCK_THREAD_CPUTIME_ID>, on systems that provide such an implementation "
"(i.e., Linux 2.6.12 and later)."
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:266
#, no-wrap
msgid "BUGS"
msgstr ""

#.  See http://bugzilla.kernel.org/show_bug.cgi?id=11972
#. type: Plain text
#: man-pages/man2/clock_getres.2:276
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: SH
#: man-pages/man2/clock_getres.2:276
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:288
msgid ""
"B<date>(1), B<gettimeofday>(2), B<settimeofday>(2), B<time>(2), "
"B<adjtime>(3), B<clock_getcpuclockid>(3), B<ctime>(3), B<ftime>(3), "
"B<pthread_getcpuclockid>(3), B<sysconf>(3), B<time>(7)"
msgstr ""

#. type: SH
#: man-pages/man2/clock_getres.2:288
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: man-pages/man2/clock_getres.2:296
msgid ""
"This page is part of release 3.70 of the Linux I<man-pages> project.  A "
"description of the project, information about reporting bugs, and the latest "
"version of this page, can be found at \\%http://www.kernel.org/doc/man-pages/"
"."
msgstr ""