.\" -*- 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 "20 luglio 2023" "Linux man\-pages 6.05.01" 
.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).
.TS
allbox;
lbx lb lb
l l l.
Interfaccia	Attributo	Valore
T{
.na
.nh
\fBerr\fP(),
\fBerrx\fP(),
\fBwarn\fP(),
\fBwarnx\fP(),
\fBverr\fP(),
\fBverrx\fP(),
\fBvwarn\fP(),
\fBvwarnx\fP()
T}	Thread safety	MT\-Safe locale
.TE
.sp 1
.SH STANDARDS
BSD.
.SH STORIA
.TP 
\fBerr\fP()
.TQ
\fBwarn\fP()
4.4BSD.
.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 .