#, 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/getcpu.2:12 #, no-wrap msgid "GETCPU" msgstr "" #. type: TH #: man-pages/man2/getcpu.2:12 #, no-wrap msgid "2013-04-03" msgstr "" #. type: TH #: man-pages/man2/getcpu.2:12 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man2/getcpu.2:12 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man2/getcpu.2:13 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:15 msgid "" "getcpu - determine CPU and NUMA node on which the calling thread is running" msgstr "" #. type: SH #: man-pages/man2/getcpu.2:15 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:18 #, no-wrap msgid "B<#include Elinux/getcpu.hE>\n" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:21 #, no-wrap msgid "" "BIB<, unsigned *>IB<, struct getcpu_cache " "*>IB<);>\n" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:25 msgid "I: There is no glibc wrapper for this system call; see NOTES." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:25 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:42 msgid "" "The B() system call identifies the processor and node on which the " "calling thread or process is currently running and writes them into the " "integers pointed to by the I and I arguments. The processor is a " "unique small integer identifying a CPU. The node is a unique small " "identifier identifying a NUMA node. When either I or I is NULL " "nothing is written to the respective pointer." msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:46 msgid "" "The third argument to this system call is nowadays unused, and should be " "specified as NULL unless portability to Linux 2.6.23 or earlier is required " "(see NOTES)." msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:61 msgid "" "The information placed in I is guaranteed to be current only at the " "time of the call: unless the CPU affinity has been fixed using " "B(2), the kernel might change the CPU at any time. " "(Normally this does not happen because the scheduler tries to minimize " "movements between CPUs to keep caches hot, but it is possible.) The caller " "must allow for the possibility that the information returned in I and " "I is no longer current by the time the call returns." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:61 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:66 msgid "" "On success, 0 is returned. On error, -1 is returned, and I is set " "appropriately." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:66 #, no-wrap msgid "ERRORS" msgstr "" #. type: TP #: man-pages/man2/getcpu.2:67 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:70 msgid "Arguments point outside the calling process's address space." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:70 #, no-wrap msgid "VERSIONS" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:73 msgid "B() was added in kernel 2.6.19 for x86_64 and i386." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:73 #, no-wrap msgid "CONFORMING TO" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:76 msgid "B() is Linux-specific." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:76 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:82 msgid "" "Linux makes a best effort to make this call as fast possible. The intention " "of B() is to allow programs to make optimizations with per-CPU data " "or for NUMA optimization." msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:88 msgid "" "Glibc does not provide a wrapper for this system call; call it using " "B(2); or use B(3) instead." msgstr "" #. commit 4307d1e5ada595c87f9a4d16db16ba5edb70dcb1 #. Author: Ingo Molnar #. Date: Wed Nov 7 18:37:48 2007 +0100 #. x86: ignore the sys_getcpu() tcache parameter #. ===== Before kernel 2.6.24: ===== #. .I tcache #. is a pointer to a #. .IR "struct getcpu_cache" #. that is used as a cache by #. .BR getcpu (). #. The caller should put the cache into a thread-local variable #. if the process is multithreaded, #. because the cache cannot be shared between different threads. #. .I tcache #. can be NULL. #. If it is not NULL #. .BR getcpu () #. will use it to speed up operation. #. The information inside the cache is private to the system call #. and should not be accessed by the user program. #. The information placed in the cache can change between kernel releases. #. When no cache is specified #. .BR getcpu () #. will be slower, #. but always retrieve the current CPU and node information. #. With a cache #. .BR getcpu () #. is faster. #. However, the cached information is updated only once per jiffy (see #. .BR time (7)). #. This means that the information could theoretically be out of date, #. although in practice the scheduler's attempt to maintain #. soft CPU affinity means that the information is unlikely to change #. over the course of the caching interval. #. type: Plain text #: man-pages/man2/getcpu.2:139 msgid "" "The I argument is unused since Linux 2.6.24. In earlier kernels, if " "this argument was non-NULL, then it specified a pointer to a caller-" "allocated buffer in thread-local storage that was used to provide a caching " "mechanism for B(). Use of the cache could speed B() calls, " "at the cost that there was a very small chance that the returned information " "would be out of date. The caching mechanism was considered to cause " "problems when migrating threads between CPUs, and so the argument is now " "ignored." msgstr "" #. type: SH #: man-pages/man2/getcpu.2:139 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:145 msgid "" "B(2), B(2), B(2), " "B(3), B(7)" msgstr "" #. type: SH #: man-pages/man2/getcpu.2:145 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man2/getcpu.2:153 msgid "" "This page is part of release 3.70 of the Linux I 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 ""