.\" Copyright (c) 1988, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" This code is derived from software contributed to Berkeley by .\" the American National Standards Committee X3, on Information .\" Processing Systems. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) tmpnam. 3 8.2 (Berkeley) 11/17/93 .\" %FreeBSD: src/lib/libc/stdio/tmpnam. 3, v 1.5. 2.5 2001/12/14 18:33:57 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/tmpnam. 3, v 1.2 2002/05/18 07:12:57 horikawa Exp $ .Dd November 17, 1993 .Dt TMPFILE 3 .Os .Sh 명칭 .Nm tempnam , .Nm tmpfile , .Nm tmpnam .Nd 일시파일 routine .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In stdio.h .Ft FILE * .Fn tmpfile void .Ft char * .Fn tmpnam "char *str" .Ft char * .Fn tempnam "const char *tmpdir" "const char *prefix" .Sh 해설 .Fn tmpfile 함수는, .Xr mkstemp 3 routine에 의해 돌려주어진 파일 기술자에게 결합된 스트림에의 포인터를 돌려줍니다. 작성된 파일은 .Fn tmpfile 함수로부터 돌아가기 전에 링크가 삭제됩니다. 그 때문에, 그 파일에의 마지막 참조가 닫혀졌을 때에, 파일은 자동적으로 삭제됩니다. 그 파일은, 액세스치 .Ql w+ 에 의해 열립니다. .Ev TMPDIR 하지만 설정되어 있는 경우, 파일은, 이 환경 변수에 의해 결정된다 디렉토리에 작성됩니다. .Ev TMPDIR 하지만 설정되어 있지 않은 경우의 기본값은 .Pa /tmp 입니다. .Pp .Fn tmpnam 함수는, 과거가 있는 불특정의 시점에서 .Dv P_tmpdir 디렉토리에 존재하고 있던 파일을 참조하고 있던 것은 아니다 파일명에의 포인터를 돌려줍니다. .Dv P_tmpdir (은)는, 인클루드 파일 .Aq Pa stdio.h 중(안)에서 정의되고 있습니다. 인수 .Fa str 하지만 .Dv NULL (이)가 아닌 경우는, 파일명은 그것이 참조하는 버퍼에 카피됩니다. 그 이외의 경우는, 파일명은 정적 버퍼에 카피됩니다. 어느 쪽의 경우에서도, .Fn tmpnam 함수는 그 파일명에의 포인터를 돌려줍니다. .Pp .Fa str 에 의해 참조되는 버퍼의 길이는, 적어도 .Dv L_tmpnam 바이트 없으면 안됩니다. .Dv L_tmpnam (은)는, 인클루드 파일 .Aq Pa stdio.h 중(안)에서 정의되고 있습니다. .Pp .Fn tempnam 함수는, .Fn tmpnam 함수와 같은 물건입니다만, 일시파일을 수용하는 디렉토리와 파일뼹레픽스를 지정하는 기능을 가지고 있습니다. .Pp 일시파일을 보존하는 디렉토리로서는, 환경 변수 .Ev TMPDIR (이것이 설정되어 있는 경우), 인수 .Fa tmpdir (이것이 .Dv NULL (이)가 아닌 경우), 디렉토리 .Dv P_tmpdir , 디렉토리 .Pa /tmp 하지만, 이 차례로 시험 받습니다. .Pp 파일뼹레픽스를 지정하기 위해서는, 값이 .Dv NULL (이)가 아닌 경우는 인수 .Fa prefix 하지만 사용되어 이것이 작성되는 파일명의 최초의 부분이 됩니다. .Fn tempnam 함수는, 파일명을 보존하는 메모리를 할당합니다. 돌려주어진 포인터는, .Xr free 3 에의 다음에 계속되는 인수로서 사용할 수가 있습니다. .Sh 반환값 .Fn tmpfile 함수는, 성공했을 경우에는 열린 파일 스트림에의 포인터를, 에러의 경우에는 .Dv NULL 포인터를 돌려줍니다. .Pp .Fn tmpnam 및 .Fn tempfile 함수는, 성공했을 경우에는 파일명에의 포인터를, 에러의 경우에는 .Dv NULL 포인터를 돌려줍니다. .Sh 에러 .Fn tmpfile 함수가 실패했을 경우, 프로그램 라이브러리 함수 .Xr fdopen 3 또는 .Xr mkstemp 3 그리고 규정되는 에러중 한쪽이, 글로벌 변수 .Va errno (으)로 설정되는 경우가 있습니다. .Pp .Fn tmpnam 함수가 실패했을 경우, 프로그램 라이브러리 함수 .Xr mktemp 3 그리고 규정되는 에러중 한쪽이 .Va errno 하지만 설정되는 경우가 있습니다. .Pp .Fn tempnam 함수가 실패했을 경우, 프로그램 라이브러리 함수 .Xr malloc 3 또는 .Xr mktemp 3 그리고 규정되는 에러중 한쪽이 .Va errno 하지만 설정되는 경우가 있습니다. .Sh 참조 .Xr mkstemp 3 , .Xr mktemp 3 .Sh 표준 .Fn tmpfile 및 .Fn tmpnam 함수는, .St -isoC 에 적합하고 있습니다. .Sh 버그 이러한 인터페이스는, System V 및 .Tn ANSI (와)과의 호환성만을 위해서(때문에) 제공되고 있습니다. .Xr mkstemp 3 인터페이스의 사용을 강하게 추천 합니다. .Pp 이러한 인터페이스에는 (낡다 .Xr mktemp 3 인터페이스와 같게), 4 개(살)의 중대한 문제가 있습니다. 가장 먼저, 파일명 선택과 파일 작성 및 삭제동안에는 분명한 경합이 있습니다. 2번째로, 대부분의 낡은 시스템에서는, 파일명이 리사이클 될 때까지는, 한정된 수 (통상은 26)의 일시파일명 밖에 사용할 수 없는 것입니다. 제3에, 이러한 함수 ( 및 .Xr mktemp 3 )의 System V 에 있어서의 실장은, 일시파일 작성의 가부를 결정하기 위해서(때문에) .Xr access 2 함수를 이용하고 있는 것입니다. 이것은, setuid 및 setgid 프로그램에 대해서 분명한 문제를 파생시켜, 이러한 프로그램에 이러한 인터페이스를 이식해 사용하는 것을 복잡하게 합니다. 마지막으로, 일시파일을 작성하는 허가에 관한 지정이 없습니다. .Pp 이 실장에는 이러한 결함은 없습니다만, 이식 가능한 소프트웨어는 그것을 의지할 수 없습니다. 특히, .Fn tmpfile 인터페이스는, 유저가 일시파일을 공개해 읽고 쓰기 가능하게 하는 것을 바라지 않을 가능성이 있는 경우는, 다른 시스템상에서 사용되는 것이 예상된다 소프트웨어 중(안)에서는 사용해야 하는 것이 아닙니다.