Content-type: text/html
Manpage of IPSEC_RANGETOSUBNET
IPSEC_RANGETOSUBNET
Section: C Library Functions (3)
Updated: 8 Sept 2000
Index
Return to Main Contents
NAME
ipsec rangetosubnet - convert address range to subnet
SYNOPSIS
#include <freeswan.h>
const char *rangetosubnet(const ip_address *start,
const ip_address *stop, ip_subnet *dst);
DESCRIPTION
Rangetosubnet
accepts two IP addresses which define an address range,
from
start
to
stop
inclusive,
and converts this to a subnet if possible.
The addresses must both be IPv4 or both be IPv6,
and the address family of the resulting subnet is the same.
Rangetosubnet
returns NULL for success and
a pointer to a string-literal error message for failure;
see DIAGNOSTICS.
SEE ALSO
ipsec_initsubnet(3), ipsec_ttosubnet(3)
DIAGNOSTICS
Fatal errors in
rangetosubnet
are:
mixed address families;
unknown address family;
start
and
stop
do not define a subnet.
HISTORY
Written for the FreeS/WAN project by Henry Spencer.
BUGS
The restriction of error reports to literal strings
(so that callers don't need to worry about freeing them or copying them)
does limit the precision of error reporting.
The error-reporting convention lends itself
to slightly obscure code,
because many readers will not think of NULL as signifying success.
A good way to make it clearer is to write something like:
-
const char *error;
error = rangetosubnet( /* ... */ );
if (error != NULL) {
/* something went wrong */
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- SEE ALSO
-
- DIAGNOSTICS
-
- HISTORY
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 05:09:32 GMT, June 19, 2001