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