diff options
Diffstat (limited to 'templates/man3/mtrace.3.pot')
| -rw-r--r-- | templates/man3/mtrace.3.pot | 469 |
1 files changed, 469 insertions, 0 deletions
diff --git a/templates/man3/mtrace.3.pot b/templates/man3/mtrace.3.pot new file mode 100644 index 00000000..b2c4ed58 --- /dev/null +++ b/templates/man3/mtrace.3.pot @@ -0,0 +1,469 @@ +# 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: 2024-03-01 17:02+0100\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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "mtrace" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "mtrace, muntrace - malloc tracing" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<#include E<lt>mcheck.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<void mtrace(void);>\n" +"B<void muntrace(void);>\n" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<mtrace>() function installs hook functions for the memory-allocation " +"functions (B<malloc>(3), B<realloc>(3) B<memalign>(3), B<free>(3)). These " +"hook functions record tracing information about memory allocation and " +"deallocation. The tracing information can be used to discover memory leaks " +"and attempts to free nonallocated memory in a program." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<muntrace>() function disables the hook functions installed by " +"B<mtrace>(), so that tracing information is no longer recorded for the " +"memory-allocation functions. If no hook functions were successfully " +"installed by B<mtrace>(), B<muntrace>() does nothing." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"When B<mtrace>() is called, it checks the value of the environment variable " +"B<MALLOC_TRACE>, which should contain the pathname of a file in which the " +"tracing information is to be recorded. If the pathname is successfully " +"opened, it is truncated to zero length." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If B<MALLOC_TRACE> is not set, or the pathname it specifies is invalid or " +"not writable, then no hook functions are installed, and B<mtrace>() has no " +"effect. In set-user-ID and set-group-ID programs, B<MALLOC_TRACE> is " +"ignored, and B<mtrace>() has no effect." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ATTRIBUTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"For an explanation of the terms used in this section, see B<attributes>(7)." +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Interface" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Attribute" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Value" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".na\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid ".nh\n" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"B<mtrace>(),\n" +"B<muntrace>()" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "Thread safety" +msgstr "" + +#. type: tbl table +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "MT-Unsafe" +msgstr "" + +# +# +#. FIXME: The marking is different from that in the glibc manual, +#. markings in glibc manual are more detailed: +#. mtrace: MT-Unsafe env race:mtrace const:malloc_hooks init +#. muntrace: MT-Unsafe race:mtrace const:malloc_hooks locale +#. But there is something wrong in glibc manual, for example: +#. glibc manual says muntrace should have marking locale because it calls +#. fprintf(), but muntrace does not execute area which cause locale problem. +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "STANDARDS" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "GNU." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"In normal usage, B<mtrace>() is called once at the start of execution of a " +"program, and B<muntrace>() is never called." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The tracing output produced after a call to B<mtrace>() is textual, but not " +"designed to be human readable. The GNU C library provides a Perl script, " +"B<mtrace>(1), that interprets the trace log and produces human-readable " +"output. For best results, the traced program should be compiled with " +"debugging enabled, so that line-number information is recorded in the " +"executable." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The tracing performed by B<mtrace>() incurs a performance penalty (if " +"B<MALLOC_TRACE> points to a valid, writable pathname)." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The line-number information produced by B<mtrace>(1) is not always precise: " +"the line number references may refer to the previous or following " +"(nonblank) line of the source code." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The shell session below demonstrates the use of the B<mtrace>() function " +"and the B<mtrace>(1) command in a program that has memory leaks at two " +"different locations. The demonstration uses the following program:" +msgstr "" + +#. #-#-#-#-# archlinux: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. [[memory leak]] SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# debian-bookworm: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# debian-unstable: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# fedora-40: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. [[memory leak]] SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# fedora-rawhide: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. [[memory leak]] SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# mageia-cauldron: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. [[memory leak]] SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# opensuse-leap-15-6: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC BEGIN (t_mtrace.c) +#. type: Plain text +#. #-#-#-#-# opensuse-tumbleweed: mtrace.3.pot (PACKAGE VERSION) #-#-#-#-# +#. SRC BEGIN (t_mtrace.c) +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "$ B<cat t_mtrace.c>" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#include E<lt>mcheck.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"\\&\n" +"int\n" +"main(void)\n" +"{\n" +" mtrace();\n" +"\\&\n" +" for (unsigned int j = 0; j E<lt> 2; j++)\n" +" malloc(100); /* Never freed--a memory leak */\n" +"\\&\n" +" calloc(16, 16); /* Never freed--a memory leak */\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"When we run the program as follows, we see that B<mtrace>() diagnosed " +"memory leaks at two different locations in the program:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +"$ B<cc -g t_mtrace.c -o t_mtrace>\n" +"$ B<export MALLOC_TRACE=/tmp/t>\n" +"$ B<./t_mtrace>\n" +"$ B<mtrace ./t_mtrace $MALLOC_TRACE>\n" +"Memory not freed:\n" +"-----------------\n" +" Address Size Caller\n" +"0x084c9378 0x64 at /home/cecilia/t_mtrace.c:12\n" +"0x084c93e0 0x64 at /home/cecilia/t_mtrace.c:12\n" +"0x084c9448 0x100 at /home/cecilia/t_mtrace.c:16\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The first two messages about unfreed memory correspond to the two " +"B<malloc>(3) calls inside the I<for> loop. The final message corresponds " +"to the call to B<calloc>(3) (which in turn calls B<malloc>(3))." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<mtrace>(1), B<malloc>(3), B<malloc_hook>(3), B<mcheck>(3)" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "2022-12-15" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "These functions are GNU extensions." +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#include E<lt>mcheck.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(void)\n" +"{\n" +" mtrace();\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" for (unsigned int j = 0; j E<lt> 2; j++)\n" +" malloc(100); /* Never freed--a memory leak */\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" calloc(16, 16); /* Never freed--a memory leak */\n" +" exit(EXIT_SUCCESS);\n" +"}\n" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "2023-07-20" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "2023-03-30" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |