.\" Copyright (c) 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" 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. .\" .\" From: @(#) err. 3 8.1 (Berkeley) 6/9/93 .\" %FreeBSD: src/lib/libc/gen/err. 3, v 1.11. 2.6 2001/12/14 18:33:51 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/err. 3, v 1.4 2002/05/18 07:12:54 horikawa Exp $ .Dd March 6, 1999 .Dt ERR 3 .Os .Sh 명칭 .Nm err , .Nm verr , .Nm errc , .Nm verrc , .Nm errx , .Nm verrx , .Nm warn , .Nm vwarn , .Nm warnc , .Nm vwarnc , .Nm warnx , .Nm vwarnx , .Nm err_set_exit , .Nm err_set_file .Nd 포맷 된 에러 메세지 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In err.h .Ft void .Fn err "int eval" "const char *fmt" "..." .Ft void .Fn err_set_exit "void (*exitf)(int)" .Ft void .Fn err_set_file "void *vfp" .Ft void .Fn errc "int eval" "int code" "const char *fmt" "..." .Ft void .Fn errx "int eval" "const char *fmt" "..." .Ft void .Fn warn "const char *fmt" "..." .Ft void .Fn warnc "int code" "const char *fmt" "..." .Ft void .Fn warnx "const char *fmt" "..." .In stdarg.h .Ft void .Fn verr "int eval" "const char *fmt" "va_list args" .Ft void .Fn verrc "int eval" "int code" "const char *fmt" "va_list args" .Ft void .Fn verrx "int eval" "const char *fmt" "va_list args" .Ft void .Fn vwarn "const char *fmt" "va_list args" .Ft void .Fn vwarnc "int code" "const char *fmt" "va_list args" .Ft void .Fn vwarnx "const char *fmt" "va_list args" .Sh 해설 .Fn err 함수와 .Fn warn 함수의 패밀리는, 표준 에러 출력, 또는 .Fn err_set_file 함수를 사용해 지정한 다른 파일상에 포맷 끝난 에러 메세지를 표시합니다. 모든 경우에, 프로그램명의 마지막 컴퍼넌트, 코론캐라크타, 및 스페이스가 출력됩니다. .Fa fmt 인수가 NULL 가 아닌 경우, .Xr printf 3 (와)과 같은 포맷 끝난 에러 메세지가 출력됩니다. 출력의 마지막에는 개행 캐릭터가 붙습니다. .Pp .Fn err , .Fn errc , .Fn verr , .Fn verrc , .Fn warn , .Fn warnc , .Fn vwarn , .Fn vwarnc 의 함수는, code 또는 광역 변수 .Va errno 에 따르는 에러 메세지를, 전에 코론과 공백을 붙여, 부가합니다. 다만, .Fa fmt 인수가 .Dv NULL 의 경우는 예외입니다. .Pp .Fn errc , .Fn verrc , .Fn warnc , 및 .Fn vwarnc 의 각 함수의 경우, .Va code 인수가 에러 메세지의 검색에 사용됩니다. .Pp .Fn err , .Fn verr , .Fn warn , 및 .Fn vwarn 의 각 함수는, 글로벌 변수 .Va errno (을)를 사용해 에러 메세지를 검색합니다. .Pp .Fn errx 함수 및 .Fn warnx 함수는, 에러 메세지를 추가하지 않습니다. .Pp .Fn err , .Fn verr , .Fn errc , .Fn verrc , .Fn errx , 및 .Fn verrx 의 각 함수는, 돌아오지 않습니다만, 인수 .Fa eval 의 값으로 종료합니다. .Fn err_set_exit 함수를 사용해, .Xr exit 3 의 전에 불려 가는 함수를 지정해, 필요한 클린 업을 실행할 수 있습니다. .Va exitf 용으로 NULL 함수 포인터를 할당하면(자), 훅이 아무것도 하지 않게 리셋트 됩니다. 함수는, 다른 함수가 사용하는 출력 스트림을 설정합니다. .Fa vfp 인수는, 열려 있는 스트림 (이미 void * 에 변환되고 있을지도 모릅니다) 인가, NULL 포인터입니다 (이 경우 출력 스트림은 표준 에러로 설정됩니다). .Sh 예 현재의 errno 정보를 표시해 종료합니다. .Bd -literal -offset indent if ((p = malloc(size)) == NULL) err(1, NULL); if ((fd = open(file_name, O_RDONLY, 0)) == -1) err(1, "%s", file_name); .Ed .Pp 에러 메세지를 표시해 종료합니다. .Bd -literal -offset indent if (tm.tm_hour < START_TIME) errx(1, "too early, wait until %s", start_time_string); .Ed .Pp 에러의 경고 .Bd -literal -offset indent if ((fd = open(raw_device, O_RDONLY, 0)) == -1) warnx("%s: %s: trying the block device", raw_device, strerror(errno)); if ((fd = open(block_device, O_RDONLY, 0)) == -1) err(1, "%s", block_device); .Ed .Pp 글로벌 변수 .Va errno (을)를 사용하지 않는 에러의 경고 .Bd -literal -offset indent error = my_function(); /* returns a value from */ if (error ! = 0) warnc(error, "my_function"); .Ed .Sh 관련 항목 .Xr exit 3 , .Xr printf 3 , .Xr strerror 3 .Pp .Sh 역사 .Fn err 함수와 .Fn warn 함수는 최초로 .Bx 4.4 그리고 나타났습니다. .Fn err_set_exit 함수 .Fn err_set_file 함수는 최초로 .Fx 2.1 그리고 나타났습니다. .Fn errc 함수와 .Fn warnc 함수는 최초로 .Fx 3.0 그리고 나타났습니다.