#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:57+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages/man5/core.5:25 #, no-wrap msgid "CORE" msgstr "" #. type: TH #: man-pages/man5/core.5:25 #, no-wrap msgid "2014-05-28" msgstr "" #. type: TH #: man-pages/man5/core.5:25 #, no-wrap msgid "Linux" msgstr "" #. type: TH #: man-pages/man5/core.5:25 #, no-wrap msgid "Linux Programmer's Manual" msgstr "" #. type: SH #: man-pages/man5/core.5:26 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages/man5/core.5:28 msgid "core - core dump file" msgstr "" #. type: SH #: man-pages/man5/core.5:28 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages/man5/core.5:39 msgid "" "The default action of certain signals is to cause a process to terminate and " "produce a I, a disk file containing an image of the " "process's memory at the time of termination. This image can be used in a " "debugger (e.g., B(1)) to inspect the state of the program at the time " "that it terminated. A list of the signals which cause a process to dump " "core can be found in B(7)." msgstr "" #. type: Plain text #: man-pages/man5/core.5:46 msgid "" "A process can set its soft B resource limit to place an upper " "limit on the size of the core dump file that will be produced if it receives " "a \"core dump\" signal; see B(2) for details." msgstr "" #. type: Plain text #: man-pages/man5/core.5:49 msgid "" "There are various circumstances in which a core dump file is not produced:" msgstr "" #. type: IP #: man-pages/man5/core.5:49 man-pages/man5/core.5:66 man-pages/man5/core.5:70 man-pages/man5/core.5:74 man-pages/man5/core.5:77 man-pages/man5/core.5:90 man-pages/man5/core.5:93 man-pages/man5/core.5:106 man-pages/man5/core.5:223 man-pages/man5/core.5:227 man-pages/man5/core.5:230 man-pages/man5/core.5:234 #, no-wrap msgid "*" msgstr "" #. type: Plain text #: man-pages/man5/core.5:66 msgid "" "The process does not have permission to write the core file. (By default, " "the core file is called I or I, where I is the ID of " "the process that dumped core, and is created in the current working " "directory. See below for details on naming.) Writing the core file will " "fail if the directory in which it is to be created is nonwritable, or if a " "file with the same name exists and is not writable or is not a regular file " "(e.g., it is a directory or a symbolic link)." msgstr "" #. type: Plain text #: man-pages/man5/core.5:70 msgid "" "A (writable, regular) file with the same name as would be used for the core " "dump already exists, but there is more than one hard link to that file." msgstr "" #. type: Plain text #: man-pages/man5/core.5:74 msgid "" "The filesystem where the core dump file would be created is full; or has run " "out of inodes; or is mounted read-only; or the user has reached their quota " "for the filesystem." msgstr "" #. type: Plain text #: man-pages/man5/core.5:77 msgid "" "The directory in which the core dump file is to be created does not exist." msgstr "" #. type: Plain text #: man-pages/man5/core.5:90 msgid "" "The B (core file size) or B (file size) resource " "limits for the process are set to zero; see B(2) and the " "documentation of the shell's I command (I in B(1))." msgstr "" #. type: Plain text #: man-pages/man5/core.5:93 msgid "" "The binary being executed by the process does not have read permission " "enabled." msgstr "" #. FIXME . Perhaps relocate discussion of /proc/sys/fs/suid_dumpable #. and PR_SET_DUMPABLE to this page? #. type: Plain text #: man-pages/man5/core.5:106 msgid "" "The process is executing a set-user-ID (set-group-ID) program that is owned " "by a user (group) other than the real user (group) ID of the process. " "(However, see the description of the B(2) B " "operation, and the description of the I file in " "B(5).)" msgstr "" #. commit 046d662f481830e652ac34cd112249adde16452a #. type: Plain text #: man-pages/man5/core.5:112 msgid "" "(Since Linux 3.7) The kernel was configured without the B " "option." msgstr "" #. type: Plain text #: man-pages/man5/core.5:118 msgid "" "In addition, a core dump may exclude part of the address space of the " "process if the B(2) B flag was employed." msgstr "" #. type: SS #: man-pages/man5/core.5:118 #, no-wrap msgid "Naming of core dump files" msgstr "" #. type: Plain text #: man-pages/man5/core.5:127 msgid "" "By default, a core dump file is named I, but the I file (since Linux 2.6 and 2.4.21) can be set to define a " "template that is used to name core dump files. The template can contain % " "specifiers which are substituted by the following values when a core file is " "created:" msgstr "" #. type: TP #: man-pages/man5/core.5:130 #, no-wrap msgid "%%" msgstr "" #. type: Plain text #: man-pages/man5/core.5:133 msgid "a single % character" msgstr "" #. type: TP #: man-pages/man5/core.5:133 #, no-wrap msgid "%c" msgstr "" #. type: Plain text #: man-pages/man5/core.5:136 msgid "" "core file size soft resource limit of crashing process (since Linux 2.6.24)" msgstr "" #. type: TP #: man-pages/man5/core.5:136 #, no-wrap msgid "%d" msgstr "" #. Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1 #. type: Plain text #: man-pages/man5/core.5:143 msgid "" "dump mode\\(emsame as value returned by B(2) B " "(since Linux 3.7)" msgstr "" #. type: TP #: man-pages/man5/core.5:143 #, no-wrap msgid "%e" msgstr "" #. type: Plain text #: man-pages/man5/core.5:146 msgid "executable filename (without path prefix)" msgstr "" #. type: TP #: man-pages/man5/core.5:146 #, no-wrap msgid "%E" msgstr "" #. type: Plain text #: man-pages/man5/core.5:151 msgid "" "pathname of executable, with slashes (\\(aq/\\(aq) replaced by exclamation " "marks (\\(aq!\\(aq) (since Linux 3.0)." msgstr "" #. type: TP #: man-pages/man5/core.5:151 #, no-wrap msgid "%g" msgstr "" #. type: Plain text #: man-pages/man5/core.5:154 msgid "(numeric) real GID of dumped process" msgstr "" #. type: TP #: man-pages/man5/core.5:154 #, no-wrap msgid "%h" msgstr "" #. type: Plain text #: man-pages/man5/core.5:157 msgid "hostname (same as I returned by B(2))" msgstr "" #. type: TP #: man-pages/man5/core.5:157 #, no-wrap msgid "%p" msgstr "" #. type: Plain text #: man-pages/man5/core.5:161 msgid "" "PID of dumped process, as seen in the PID namespace in which the process " "resides" msgstr "" #. type: TP #: man-pages/man5/core.5:161 #, no-wrap msgid "%P" msgstr "" #. Added in git commit 65aafb1e7484b7434a0c1d4c593191ebe5776a2f #. type: Plain text #: man-pages/man5/core.5:166 msgid "" "PID of dumped process, as seen in the initial PID namespace (since Linux 3." "12)" msgstr "" #. type: TP #: man-pages/man5/core.5:166 #, no-wrap msgid "%s" msgstr "" #. type: Plain text #: man-pages/man5/core.5:169 msgid "number of signal causing dump" msgstr "" #. type: TP #: man-pages/man5/core.5:169 #, no-wrap msgid "%t" msgstr "" #. type: Plain text #: man-pages/man5/core.5:173 msgid "" "time of dump, expressed as seconds since the Epoch, 1970-01-01 00:00:00 " "+0000 (UTC)" msgstr "" #. type: TP #: man-pages/man5/core.5:173 #, no-wrap msgid "%u" msgstr "" #. type: Plain text #: man-pages/man5/core.5:176 msgid "(numeric) real UID of dumped process" msgstr "" #. type: Plain text #: man-pages/man5/core.5:195 msgid "" "A single % at the end of the template is dropped from the core filename, as " "is the combination of a % followed by any character other than those listed " "above. All other characters in the template become a literal part of the " "core filename. The template may include \\(aq/\\(aq characters, which are " "interpreted as delimiters for directory names. The maximum size of the " "resulting core filename is 128 bytes (64 bytes in kernels before 2.6.19). " "The default value in this file is \"core\". For backward compatibility, if " "I does not include \"%p\" and I (see below) is nonzero, then .PID will be appended to " "the core filename." msgstr "" #. type: Plain text #: man-pages/man5/core.5:206 msgid "" "Since version 2.4, Linux has also provided a more primitive method of " "controlling the name of the core dump file. If the I file contains the value 0, then a core dump file is simply " "named I. If this file contains a nonzero value, then the core dump " "file includes the process ID in a name of the form I." msgstr "" #. 9520628e8ceb69fa9a4aee6b57f22675d9e1b709 #. type: Plain text #: man-pages/man5/core.5:213 msgid "" "Since Linux 3.6, if I is set to 2 " "(\"suidsafe\"), the pattern must be either an absolute pathname (starting " "with a leading \\(aq/\\(aq character) or a pipe, as defined below." msgstr "" #. type: SS #: man-pages/man5/core.5:213 #, no-wrap msgid "Piping core dumps to a program" msgstr "" #. type: Plain text #: man-pages/man5/core.5:223 msgid "" "Since kernel 2.6.19, Linux supports an alternate syntax for the I file. If the first character of this file is a pipe " "symbol (B<|>), then the remainder of the line is interpreted as a program to " "be executed. Instead of being written to a disk file, the core dump is " "given as standard input to the program. Note the following points:" msgstr "" #. type: Plain text #: man-pages/man5/core.5:227 msgid "" "The program must be specified using an absolute pathname (or a pathname " "relative to the root directory, I), and must immediately follow the '|' " "character." msgstr "" #. type: Plain text #: man-pages/man5/core.5:230 msgid "The process created to run the program runs as user and group I." msgstr "" #. type: Plain text #: man-pages/man5/core.5:234 msgid "" "Command-line arguments can be supplied to the program (since Linux 2.6.24), " "delimited by white space (up to a total line length of 128 bytes)." msgstr "" #. type: Plain text #: man-pages/man5/core.5:240 msgid "" "The command-line arguments can include any of the % specifiers listed above. " " For example, to pass the PID of the process that is being dumped, specify " "I<%p> in an argument." msgstr "" #. type: SS #: man-pages/man5/core.5:240 #, no-wrap msgid "Controlling which mappings are written to the core dump" msgstr "" #. type: Plain text #: man-pages/man5/core.5:246 msgid "" "Since kernel 2.6.23, the Linux-specific I file " "can be used to control which memory segments are written to the core dump " "file in the event that a core dump is performed for the process with the " "corresponding process ID." msgstr "" #. type: Plain text #: man-pages/man5/core.5:252 msgid "" "The value in the file is a bit mask of memory mapping types (see B(2))." " If a bit is set in the mask, then memory mappings of the corresponding " "type are dumped; otherwise they are not dumped. The bits in this file have " "the following meanings:" msgstr "" #. type: TP #: man-pages/man5/core.5:255 #, no-wrap msgid "bit 0" msgstr "" #. type: Plain text #: man-pages/man5/core.5:258 msgid "Dump anonymous private mappings." msgstr "" #. type: TP #: man-pages/man5/core.5:258 #, no-wrap msgid "bit 1" msgstr "" #. type: Plain text #: man-pages/man5/core.5:261 msgid "Dump anonymous shared mappings." msgstr "" #. type: TP #: man-pages/man5/core.5:261 #, no-wrap msgid "bit 2" msgstr "" #. type: Plain text #: man-pages/man5/core.5:264 msgid "Dump file-backed private mappings." msgstr "" #. type: TP #: man-pages/man5/core.5:264 #, no-wrap msgid "bit 3" msgstr "" #. file-backed shared mappings of course also update the underlying #. mapped file. #. type: Plain text #: man-pages/man5/core.5:269 msgid "Dump file-backed shared mappings." msgstr "" #. type: TP #: man-pages/man5/core.5:269 #, no-wrap msgid "bit 4 (since Linux 2.6.24)" msgstr "" #. type: Plain text #: man-pages/man5/core.5:272 msgid "Dump ELF headers." msgstr "" #. type: TP #: man-pages/man5/core.5:272 #, no-wrap msgid "bit 5 (since Linux 2.6.28)" msgstr "" #. type: Plain text #: man-pages/man5/core.5:275 msgid "Dump private huge pages." msgstr "" #. type: TP #: man-pages/man5/core.5:275 #, no-wrap msgid "bit 6 (since Linux 2.6.28)" msgstr "" #. type: Plain text #: man-pages/man5/core.5:278 msgid "Dump shared huge pages." msgstr "" #. type: Plain text #: man-pages/man5/core.5:286 msgid "" "By default, the following bits are set: 0, 1, 4 (if the " "B kernel configuration option is " "enabled), and 5. The value of this file is displayed in hexadecimal. (The " "default value is thus displayed as 33.)" msgstr "" #. type: Plain text #: man-pages/man5/core.5:291 msgid "" "Memory-mapped I/O pages such as frame buffer are never dumped, and virtual " "DSO pages are always dumped, regardless of the I value." msgstr "" #. type: Plain text #: man-pages/man5/core.5:301 msgid "" "A child process created via B(2) inherits its parent's " "I value; the I value is preserved across " "an B(2)." msgstr "" #. type: Plain text #: man-pages/man5/core.5:305 msgid "" "It can be useful to set I in the parent shell before " "running a program, for example:" msgstr "" #. type: Plain text #: man-pages/man5/core.5:310 #, no-wrap msgid "$B< echo 0x7 E /proc/self/coredump_filter>\n" "$B< ./some_program>\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:316 msgid "" "This file is provided only if the kernel was built with the " "B configuration option." msgstr "" #. type: SH #: man-pages/man5/core.5:316 #, no-wrap msgid "NOTES" msgstr "" #. type: Plain text #: man-pages/man5/core.5:321 msgid "" "The B(1) I command can be used to obtain a core dump of a " "running process." msgstr "" #. Changed with commit 6409324b385f3f63a03645b4422e3be67348d922 #. Always including the PID in the name of the core file made #. sense for LinuxThreads, where each thread had a unique PID, #. but doesn't seem to serve any purpose with NPTL, where all the #. threads in a process share the same PID (as POSIX.1 requires). #. Probably the behavior is maintained so that applications using #. LinuxThreads continue appending the PID (the kernel has no easy #. way of telling which threading implementation the user-space #. application is using). -- mtk, April 2006 #. type: Plain text #: man-pages/man5/core.5:344 msgid "" "In Linux versions up to and including 2.6.27, if a multithreaded process " "(or, more precisely, a process that shares its memory with another process " "by being created with the B flag of B(2)) dumps core, then " "the process ID is always appended to the core filename, unless the process " "ID was already included elsewhere in the filename via a %p specification in " "I. (This is primarily useful when employing " "the obsolete LinuxThreads implementation, where each thread of a process has " "a different PID.)" msgstr "" #. type: SH #: man-pages/man5/core.5:344 #, no-wrap msgid "EXAMPLE" msgstr "" #. type: Plain text #: man-pages/man5/core.5:352 msgid "" "The program below can be used to demonstrate the use of the pipe syntax in " "the I file. The following shell session " "demonstrates the use of this program (compiled to create an executable named " "I):" msgstr "" #. type: Plain text #: man-pages/man5/core.5:373 #, no-wrap msgid "" "$B< cc -o core_pattern_pipe_test core_pattern_pipe_test.c>\n" "$B< su>\n" "Password:\n" "#B< echo \"|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\" E \\e>\n" "B\n" "#B< exit>\n" "$B< sleep 100>\n" "B<^\\e> # type control-backslash\n" "Quit (core dumped)\n" "$B< cat core.info>\n" "argc=5\n" "argc[0]=E/home/mtk/core_pattern_pipe_testE\n" "argc[1]=E20575E\n" "argc[2]=EUID=1000E\n" "argc[3]=EGID=100E\n" "argc[4]=Esig=3E\n" "Total bytes in core dump: 282624\n" msgstr "" #. type: SS #: man-pages/man5/core.5:375 #, no-wrap msgid "Program source" msgstr "" #. type: Plain text #: man-pages/man5/core.5:379 #, no-wrap msgid "/* core_pattern_pipe_test.c */\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:387 #, no-wrap msgid "" "#define _GNU_SOURCE\n" "#include Esys/stat.hE\n" "#include Efcntl.hE\n" "#include Elimits.hE\n" "#include Estdio.hE\n" "#include Estdlib.hE\n" "#include Eunistd.hE\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:389 #, no-wrap msgid "#define BUF_SIZE 1024\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:398 #, no-wrap msgid "" "int\n" "main(int argc, char *argv[])\n" "{\n" " int tot, j;\n" " ssize_t nread;\n" " char buf[BUF_SIZE];\n" " FILE *fp;\n" " char cwd[PATH_MAX];\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:401 #, no-wrap msgid "" " /* Change our current working directory to that of the\n" " crashing process */\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:404 #, no-wrap msgid " snprintf(cwd, PATH_MAX, \"/proc/%s/cwd\", argv[1]);\n" " chdir(cwd);\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:406 #, no-wrap msgid " /* Write output to file \"core.info\" in that directory */\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:410 #, no-wrap msgid "" " fp = fopen(\"core.info\", \"w+\");\n" " if (fp == NULL)\n" " exit(EXIT_FAILURE);\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:413 #, no-wrap msgid "" " /* Display command-line arguments given to core_pattern\n" " pipe program */\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:417 #, no-wrap msgid "" " fprintf(fp, \"argc=%d\\en\", argc);\n" " for (j = 0; j E argc; j++)\n" " fprintf(fp, \"argc[%d]=E%sE\\en\", j, argv[j]);\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:419 #, no-wrap msgid " /* Count bytes in standard input (the core dump) */\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:424 #, no-wrap msgid "" " tot = 0;\n" " while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) E 0)\n" " tot += nread;\n" " fprintf(fp, \"Total bytes in core dump: %d\\en\", tot);\n" msgstr "" #. type: Plain text #: man-pages/man5/core.5:427 #, no-wrap msgid " exit(EXIT_SUCCESS);\n" "}\n" msgstr "" #. type: SH #: man-pages/man5/core.5:428 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages/man5/core.5:439 msgid "" "B(1), B(1), B(2), B(2), B(2), " "B(2), B(5), B(5), B(7), B(7)" msgstr "" #. type: SH #: man-pages/man5/core.5:439 #, no-wrap msgid "COLOPHON" msgstr "" #. type: Plain text #: man-pages/man5/core.5:447 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 ""