.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"	From: @(#)err.3	8.1 (Berkeley) 6/9/93
.\" $FreeBSD: src/lib/libc/gen/err.3,v 1.11.2.5 2001/08/17 15:42:32 ru Exp $
.\"
.\" 2011-09-10, mtk, Converted from mdoc to man macros
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH err 3 "15 dicembre 2022" "Linux man\-pages 6.03" 
.SH NOME
err, verr, errx, verrx, warn, vwarn, warnx, vwarnx \- messaggi di errore
formattati
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH SINTASSI
.nf
\fB#include <err.h>\fP
.PP
\fB[[noreturn]] void err(int \fP\fIeval\fP\fB, const char *\fP\fIfmt\fP\fB, ...);\fP
\fB[[noreturn]] void errx(int \fP\fIeval\fP\fB, const char *\fP\fIfmt\fP\fB, ...);\fP
.PP
\fBvoid warn(const char *\fP\fIfmt\fP\fB, ...);\fP
\fBvoid warnx(const char *\fP\fIfmt\fP\fB, ...);\fP
.PP
\fB#include <stdarg.h>\fP
.PP
\fB[[noreturn]] void verr(int \fP\fIeval\fP\fB, const char *\fP\fIfmt\fP\fB, va_list \fP\fIargs\fP\fB);\fP
\fB[[noreturn]] void verrx(int \fP\fIeval\fP\fB, const char *\fP\fIfmt\fP\fB, va_list \fP\fIargs\fP\fB);\fP
.PP
\fBvoid vwarn(const char *\fP\fIfmt\fP\fB, va_list \fP\fIargs\fP\fB);\fP
\fBvoid vwarnx(const char *\fP\fIfmt\fP\fB, va_list \fP\fIargs\fP\fB);\fP
.fi
.SH DESCRIZIONE
Le famiglie di funzioni \fBerr\fP() e \fBwarn\fP() visualizzano un messaggio di
errore formattato sull'uscita dello standard error. In ogni caso vengono
stampati l'ultimo componente del nome del programma, un carattere di due
punti, e uno spazio. Se l'argomento \fIfmt\fP non è NULL viene emesso un
messaggio di errore formattato in stile \fBprintf\fP(3). L'output è concluso da
un carattere newline.
.PP
Le funzioni \fBerr\fP(), \fBverr\fP(), \fBwarn\fP() e \fBvwarn\fP() aggiungono un
messaggio di errore ottenuto da \fBstrerror\fP(3) basato sulla variabile
globale \fIerrno\fP, preceduto da un altro ":" e da uno spazio a meno che
l'argomento \fIfmt\fP sia NULL.
.PP
Le funzioni \fBerrx\fP() e \fBwarnx\fP() non aggiungono un messaggio di errore.
.PP
Le funzioni \fBerr\fP(), \fBverr\fP(), \fBerrx\fP() e \fBverrx\fP() non ritornano, ma
escono con il valore dell'argomento \fIeval\fP.
.SH ATTRIBUTI
Per la spiegazione dei termini usati in questa sezione, vedere
\fBattributes\fP(7).
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Interfaccia	Attributo	Valore
T{
\fBerr\fP(),
\fBerrx\fP(),
\fBwarn\fP(),
\fBwarnx\fP(),
\fBverr\fP(),
\fBverrx\fP(),
\fBvwarn\fP(),
\fBvwarnx\fP()
T}	Thread safety	MT\-Safe locale
.TE
.hy
.ad
.sp 1
.SH STANDARDS
.\" .SH HISTORY
.\" The
.\" .BR err ()
.\" and
.\" .BR warn ()
.\" functions first appeared in
.\" 4.4BSD.
Queste funzioni sono estensioni BSD non standard.
.SH ESEMPI
Mostra la stringa di informazione attuale \fIerrno\fP ed esce:
.PP
.in +4n
.EX
p = malloc(size);
if (p == NULL)
    err(EXIT_FAILURE, NULL);
fd = open(file_name, O_RDONLY, 0);
if (fd == \-1)
    err(EXIT_FAILURE, "%s", file_name);
.EE
.in
.PP
Visualizza un messaggio di errore ed esce:
.PP
.in +4n
.EX
if (tm.tm_hour < START_TIME)
    errx(EXIT_FAILURE, "too early, wait until %s",
            start_time_string);
.EE
.in
.PP
Avvisa di un errore:
.PP
.in +4n
.EX
fd = open(raw_device, O_RDONLY, 0);
if (fd == \-1)
    warnx("%s: %s: trying the block device",
            raw_device, strerror(errno));
fd = open(block_device, O_RDONLY, 0);
if (fd == \-1)
    err(EXIT_FAILURE, "%s", block_device);
.EE
.in
.SH "VEDERE ANCHE"
\fBerror\fP(3), \fBexit\fP(3), \fBperror\fP(3), \fBprintf\fP(3), \fBstrerror\fP(3)
.PP
.SH TRADUZIONE
La traduzione italiana di questa pagina di manuale è stata creata da
Giulio Daprelà <giulio@pluto.it>,
Elisabetta Galli <lab@kkk.it>
e
Marco Curreli <marcocurreli@tiscali.it>
.
.PP
Questa traduzione è documentazione libera; leggere la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Versione 3
.UE
o successiva per le condizioni di
copyright.
Non ci assumiamo alcuna responsabilità.
.PP
Per segnalare errori nella traduzione di questa pagina di
manuale inviare un messaggio a
.MT pluto-ildp@lists.pluto.it
.ME .