Blame libipq/ipq_errstr.3

Packit Service d1fe03
.TH IPQ_ERRSTR 3 "16 October 2001" "Linux iptables 1.2" "Linux Programmer's Manual" 
Packit Service d1fe03
.\"
Packit Service d1fe03
.\"     Copyright (c) 2000 Netfilter Core Team
Packit Service d1fe03
.\"
Packit Service d1fe03
.\"     This program is free software; you can redistribute it and/or modify
Packit Service d1fe03
.\"     it under the terms of the GNU General Public License as published by
Packit Service d1fe03
.\"     the Free Software Foundation; either version 2 of the License, or
Packit Service d1fe03
.\"     (at your option) any later version.
Packit Service d1fe03
.\"
Packit Service d1fe03
.\"     This program is distributed in the hope that it will be useful,
Packit Service d1fe03
.\"     but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Service d1fe03
.\"     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit Service d1fe03
.\"     GNU General Public License for more details.
Packit Service d1fe03
.\"
Packit Service d1fe03
.\"     You should have received a copy of the GNU General Public License
Packit Service d1fe03
.\"     along with this program; if not, write to the Free Software
Packit Service d1fe03
.\"     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
Packit Service d1fe03
.\"
Packit Service d1fe03
.\"
Packit Service d1fe03
.SH NAME
Packit Service d1fe03
ipq_errstr, ipq_perror \(em libipq error handling routines
Packit Service d1fe03
.SH SYNOPSIS
Packit Service d1fe03
.B #include <linux/netfilter.h>
Packit Service d1fe03
.br
Packit Service d1fe03
.B #include <libipq.h>
Packit Service d1fe03
.sp
Packit Service d1fe03
.BI "char *ipq_errstr(" void );
Packit Service d1fe03
.br
Packit Service d1fe03
.BI "void ipq_perror(const char *" s );
Packit Service d1fe03
.SH DESCRIPTION
Packit Service d1fe03
The
Packit Service d1fe03
.B ipq_errstr
Packit Service d1fe03
function returns a descriptive error message based on the current
Packit Service d1fe03
value of the internal
Packit Service d1fe03
.B ipq_errno
Packit Service d1fe03
variable.  All libipq API functions set this internal variable
Packit Service d1fe03
upon failure.
Packit Service d1fe03
.PP
Packit Service d1fe03
The
Packit Service d1fe03
.B ipq_perror
Packit Service d1fe03
function prints an error message to stderr corresponding to the
Packit Service d1fe03
current value of the internal
Packit Service d1fe03
.B ipq_error
Packit Service d1fe03
variable, and the global
Packit Service d1fe03
.B errno
Packit Service d1fe03
variable (if set).  The error message is prefixed with the string
Packit Service d1fe03
.I s
Packit Service d1fe03
as supplied by the application. If
Packit Service d1fe03
.I s
Packit Service d1fe03
is NULL, the error message is prefixed with the string "ERROR".
Packit Service d1fe03
.SH RETURN VALUE
Packit Service d1fe03
.B ipq_errstr
Packit Service d1fe03
returns an error message as outlined above.
Packit Service d1fe03
.SH BUGS
Packit Service d1fe03
None known.
Packit Service d1fe03
.SH AUTHOR
Packit Service d1fe03
James Morris <jmorris@intercode.com.au>
Packit Service d1fe03
.SH COPYRIGHT
Packit Service d1fe03
Copyright (c) 2000-2001 Netfilter Core Team.
Packit Service d1fe03
.PP
Packit Service d1fe03
Distributed under the GNU General Public License.
Packit Service d1fe03
.SH SEE ALSO
Packit Service d1fe03
.BR iptables (8),
Packit Service d1fe03
.BR libipq (3).