OSDN Git Service

Update release for LDP 3.67
[linuxjm/LDP_man-pages.git] / release / man3 / cfree.3
index 1eb583d..b16d92b 100644 (file)
@@ -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
 .\" 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
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%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 <ysato444@yahoo.co.jp>
 .\"
-.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 <stdlib.h>"
+\fB#include <stdlib.h>\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 <stdlib.h>
-¤Ë¸ºß¤¹¤ë¾ì¹ç¤â¤¢¤ë¤·¡¢
-.I <malloc.h>
-¤Ë¸ºß¤¹¤ë¾ì¹ç¤â¤¢¤ë¡£
-.SS "°ú¤­¿ô¤¬ 3 ¤Ä¤Î cfree"
-SCO ¤È Solaris ¤Î¤¤¤¯¤Ä¤«¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ï¡¢
-°ú¤­¿ô¤¬ 3 ¤Ä¤Î
-.BR cfree ()
-¤¬´Þ¤Þ¤ì¤ë malloc ¥é¥¤¥Ö¥é¥ê¤¬¤¢¤ë¡£
-¤³¤ì¤ÏÌÀ¤é¤«¤Ë
-.BR calloc (3)
-¤ËÎà»÷¤·¤Æ¤¤¤ë¡£
+他のシステムでは、この名前の別の関数がある。 この宣言は \fI<stdlib.h>\fP に存在する場合もあるし、
+\fI<malloc.h>\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/ に書かれている。