X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Fcfree.3;h=b16d92bc28fabaec7ec0fe20d9110f5516ac0f5d;hb=dba08e2eee1afb613e4e8e9310eb752cb06f45de;hp=1eb583d3ff25556aa741d3b75a3cc251b59ad86c;hpb=633a2252e0be3c867dce264a180a89ce8181d36f;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/cfree.3 b/release/man3/cfree.3 index 1eb583d3..b16d92bc 100644 --- a/release/man3/cfree.3 +++ b/release/man3/cfree.3 @@ -1,5 +1,6 @@ .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl) .\" +.\" %%%LICENSE_START(GPLv2+_DOC_FULL) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of @@ -16,115 +17,81 @@ .\" GNU General Public License for more details. .\" .\" You should have received a copy of the GNU General Public -.\" License along with this manual; if not, write to the Free -.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, -.\" USA. +.\" License along with this manual; if not, see +.\" . +.\" %%%LICENSE_END +.\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* .\" .\" Japanese Version Copyright (c) 2004 Yuichi SATO .\" all rights reserved. .\" Translated Mon Jul 19 04:38:03 JST 2004 .\" by Yuichi SATO .\" -.TH CFREE 3 2007-07-26 "" "Linux Programmer's Manual" -.SH ̾Á° -cfree \- ³ä¤êÅö¤Æ¤é¤ì¤¿¥á¥â¥ê¤ò²òÊü¤¹¤ë -.SH ½ñ¼° +.TH CFREE 3 2007\-07\-26 "" "Linux Programmer's Manual" +.SH 名前 +cfree \- 割り当てられたメモリを解放する +.SH 書式 .nf .sp -.B "#include " +\fB#include \fP .sp -/* SunOS 4 ¤Ç¤Ï */ -.BI "int cfree(void *" ptr ); +/* SunOS 4 では */ +\fBint cfree(void *\fP\fIptr\fP\fB);\fP .sp -/* glibc ¤È FreeBSD libcompat ¤Ç¤Ï */ -.BI "void cfree(void *" ptr ); +/* glibc と FreeBSD libcompat では */ +\fBvoid cfree(void *\fP\fIptr\fP\fB);\fP .sp -/* SCO OpenServer ¤Ç¤Ï */ -.BI "void cfree(char *" ptr ", unsigned " num ", unsigned " size ); +/* SCO OpenServer では */ +\fBvoid cfree(char *\fP\fIptr\fP\fB, unsigned \fP\fInum\fP\fB, unsigned \fP\fIsize\fP\fB);\fP .sp -/* Solaris watchmalloc.so.1 ¤Ç¤Ï */ -.BI "void cfree(void *" ptr ", size_t " nelem ", size_t " elsize ); +/* Solaris watchmalloc.so.1 では */ +\fBvoid cfree(void *\fP\fIptr\fP\fB, size_t \fP\fInelem\fP\fB, size_t \fP\fIelsize\fP\fB);\fP .fi .sp .in -4n -glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï -.RB ( feature_test_macros (7) -»²¾È): +glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .in .sp -.BR cfree (): -_BSD_SOURCE || _SVID_SOURCE -.SH ÀâÌÀ -¤³¤Î´Ø¿ô¤Ï·è¤·¤Æ»ÈÍѤ¹¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£ -Âå¤ï¤ê¤Ë -.BR free (3) -¤ò»È¤¦¤³¤È¡£ -.SS "°ú¤­¿ô¤¬ 1 ¤Ä¤Î cfree" -glibc ¤Ç¤Ï¡¢´Ø¿ô -.BR cfree () -¤Ï -.BR free (3) -¤ÎÊÌ̾¤Ç¤¢¤ê¡¢¡ÖSunOS ¤È¤Î¸ß´¹À­¤Î¤¿¤á¤ËÄɲ䵤줿¡×¡£ +\fBcfree\fP(): _BSD_SOURCE || _SVID_SOURCE +.SH 説明 +この関数は決して使用すべきではない。 代わりに \fBfree\fP(3) を使うこと。 +.SS "引き数が 1 つの cfree" +glibc では、関数 \fBcfree\fP() は \fBfree\fP(3) の別名であり、「SunOS との互換性のために追加された」。 .LP -¾¤Î¥·¥¹¥Æ¥à¤Ç¤Ï¡¢¤³¤Î̾Á°¤ÎÊ̤δؿô¤¬¤¢¤ë¡£ -¤³¤ÎÀë¸À¤Ï -.I -¤Ë¸ºß¤¹¤ë¾ì¹ç¤â¤¢¤ë¤·¡¢ -.I -¤Ë¸ºß¤¹¤ë¾ì¹ç¤â¤¢¤ë¡£ -.SS "°ú¤­¿ô¤¬ 3 ¤Ä¤Î cfree" -SCO ¤È Solaris ¤Î¤¤¤¯¤Ä¤«¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ï¡¢ -°ú¤­¿ô¤¬ 3 ¤Ä¤Î -.BR cfree () -¤¬´Þ¤Þ¤ì¤ë malloc ¥é¥¤¥Ö¥é¥ê¤¬¤¢¤ë¡£ -¤³¤ì¤ÏÌÀ¤é¤«¤Ë -.BR calloc (3) -¤ËÎà»÷¤·¤Æ¤¤¤ë¡£ +他のシステムでは、この名前の別の関数がある。 この宣言は \fI\fP に存在する場合もあるし、 +\fI\fP に存在する場合もある。 +.SS "引き数が 3 つの cfree" +SCO と Solaris のいくつかのバージョンでは、 引き数が 3 つの \fBcfree\fP() が含まれる malloc ライブラリがある。 +これは明らかに \fBcalloc\fP(3) に類似している。 .LP -²¿¤«¤ò°Ü¿¢¤¹¤ë»þ¤Ë¤³¤Î´Ø¿ô¤¬É¬Íפʾì¹ç¡¢ +何かを移植する時にこの関数が必要な場合、 .sp .in +4n #define cfree(p, n, s) free((p)) .in .sp -¤ò¥Õ¥¡¥¤¥ë¤ËÄɲ乤뤳¤È¡£ +をファイルに追加すること。 .LP -¤è¤¯¿Ò¤Í¤é¤ì¤ë¼ÁÌä¤Ï -.RB ¡Ö calloc (3) -¤Ç³ä¤êÅö¤Æ¤é¤ì¤¿¥á¥â¥ê¤ò²òÊü¤¹¤ë¤Î¤Ë -.BR free (3) -¤ò»È¤¦¤³¤È¤¬¤Ç¤­¤ë¤«¡¢ -¤½¤ì¤È¤â -.BR cfree () -¤ò»È¤¦É¬Íפ¬¤¢¤ë¤«¡×¤È¤¤¤¦¤â¤Î¤Ç¤¢¤ë¡£ -Åú¤¨: -.BR free (3) -¤ò»È¤¦¤³¤È¡£ +よく尋ねられる質問は 「\fBcalloc\fP(3) で割り当てられたメモリを解放するのに \fBfree\fP(3) を使うことができるか、 それとも +\fBcfree\fP() を使う必要があるか」というものである。 答え: \fBfree\fP(3) を使うこと。 .LP -SCO ¤Î¥Þ¥Ë¥å¥¢¥ë¤Ë¤Ï°Ê²¼¤Î¤è¤¦¤Ëµ­½Ò¤µ¤ì¤Æ¤¤¤ë: -¡Öcfree ¥ë¡¼¥Á¥ó¤Ï iBCSe2 µ¬³Ê¤Ë½¾¤¦¤¿¤á¤ËÄ󶡤µ¤ì¤Æ¤ª¤ê¡¢ -ñ¤Ë free ¤ò¸Æ¤ó¤Ç¤¤¤ë¤À¤±¤Ç¤¢¤ë¡£ -cfree ¤Î num ¤È size °ú¤­¿ô¤Ï»ÈÍѤµ¤ì¤Ê¤¤¡£¡× -.SH ÊÖ¤êÃÍ -SunOS ÈǤΠ-.BR cfree () -.RB ( free (3) -¤ÎÊÌ̾) ¤Ï¡¢À®¸ù¤·¤¿¾ì¹ç¤Ë 1 ¤òÊÖ¤·¡¢¼ºÇÔ¤·¤¿¾ì¹ç¤Ë 0 ¤òÊÖ¤¹¡£ -¥¨¥é¡¼¤Î¾ì¹ç¡¢ -.I errno -¤¬ -.B EINVAL -¤ËÀßÄꤵ¤ì¤ë: -.I ptr -¤ÎÃͤ¬ -.BR malloc () -·Ï¤Î¥ë¡¼¥Á¥ó¤Î 1 ¤Ä¤Ç°ÊÁ°¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ -¥Ö¥í¥Ã¥¯¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ç¤Ê¤¤¡£ -.SH ½àµò -SCO ¤ÇÍѤ¤¤é¤ì¤Æ¤¤¤ë°ú¤­¿ô¤¬ 3 ¤Ä¤Î -.BR cfree () -¤Ï¡¢iBCSe2 µ¬³Ê: -Intel386 Binary Compatibility Specification, Edition 2 -(Intel386 ¥Ð¥¤¥Ê¥ê¸ß´¹»ÅÍÍ¡¢Âè 2 ÈÇ) ¤Ë½àµò¤¹¤ë¡£ -.SH ´ØÏ¢¹àÌÜ -.BR malloc (3) +SCO のマニュアルには以下のように記述されている: 「cfree ルーチンは iBCSe2 規格に従うために提供されており、 単に free +を呼んでいるだけである。 cfree の num と size 引き数は使用されない。」 +.SH 返り値 +SunOS 版の \fBcfree\fP() (\fBfree\fP(3) の別名) は、成功した場合に 1 を返し、失敗した場合に 0 を返す。 +エラーの場合、 \fIerrno\fP が \fBEINVAL\fP に設定される: \fIptr\fP の値が \fBmalloc\fP() 系のルーチンの 1 +つで以前に割り当てられた ブロックへのポインタでない。 +.SH 準拠 +SCO で用いられている引き数が 3 つの \fBcfree\fP() は、iBCSe2 規格: Intel386 Binary Compatibility +Specification, Edition 2 (Intel386 バイナリ互換仕様、第 2 版) に準拠する。 +.SH 関連項目 +\fBmalloc\fP(3) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。