draft/man3/mtrace.3

   1 .\"  Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"  Distributed under GPL
   3 .\"  the glibc-info pages are very helpful here
   4 .\"
   5 .\" Japanese Version Copyright (c) 2002 Akihiro MOTOKI all rights reserved.
   6 .\" Translated Thu 05 Dec 2002 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   7 .\"
   8 .TH MTRACE 3 2002-07-20 "GNU" "Linux Programmer's Manual"
   9 .\"O .SH NAME
  10 .\"O mtrace, muntrace \- malloc debugging
  11 .SH 名前
  12 mtrace, muntrace \- malloc debugging
  13 .\"O .SH SYNOPSIS
  14 .SH 書式
  15 .B "#include <mcheck.h>"
  16 .sp
  17 .B "void mtrace(void);"
  18 .sp
  19 .B "void muntrace(void);"
  20 .\"O .SH DESCRIPTION
  21 .SH 説明
  22 .\"O The function
  23 .\"O .BR mtrace ()
  24 .\"O installs handlers for
  25 .\"O .BR malloc (3),
  26 .\"O .BR realloc (3)
  27 .\"O and
  28 .\"O .BR free (3).
  29 .\"O The function
  30 .\"O .BR muntrace ()
  31 .\"O disables these handlers.
  32 関数
  33 .BR mtrace ()
  34 は、
  35 .BR malloc (3),
  36 .BR realloc (3),
  37 .BR free (3)
  38 のハンドラを組み込む。
  39 関数
  40 .BR muntrace ()
  41 はこれらのハンドラを解除する。
  42 .br
  43 .\"O The environment variable
  44 .\"O .B MALLOC_TRACE
  45 .\"O defines a file where
  46 .\"O .BR mtrace ()
  47 .\"O writes its output.
  48 環境変数
  49 .B MALLOC_TRACE
  50 は
  51 .BR mtrace ()
  52 が出力を書き出すファイルを指定する。
  53 .\"O This file must be writable to the user or
  54 .\"O .BR mtrace ()
  55 .\"O will do nothing.
  56 ユーザが書き込み権限を持つファイルを指定しなければならない。
  57 書き込み権限がない場合、
  58 .BR mtrace ()
  59 は何もしない。
  60 .\"O If the file is not empty it will be truncated.
  61 .\" motoki: truncate って「後ろを切ってしまう」ような意味のはずだけど
  62 .\" motoki: 実際に試してみると、元のファイルを上書きするようです・・・
  63 ファイルが空でない場合、ファイルの元の内容を上書きする。
  64 .\"O .SH "CONFORMING TO"
  65 .SH 準拠
  66 .\"O These are GNU extensions.
  67 この関数は GNU 拡張である。
  68 .\"O .SH NOTES
  69 .SH 注意
  70 .\"O The output of
  71 .\"O .BR mtrace ()
  72 .\"O will be ASCII but not in a friendly format.
  73 .\"O So glibc comes with a perl-script called mtrace to make sense of it.
  74 .BR mtrace ()
  75 の出力は ASCII 形式だが、人が読みやすいフォーマットではない。
  76 そこで、glibc には mtrace 出力を分かりやすい形式に変換する
  77 perl スクリプトが付属している。
  78 .\"O .SH "SEE ALSO"
  79 .SH 関連項目
  80 .BR malloc (3),
  81 .BR malloc_hook (3)