debian man page for ipsec_rangetosubnet

Query: ipsec_rangetosubnet

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

IPSEC_RANGETOSUBNET(3)						    8 Sept 2000 					    IPSEC_RANGETOSUBNET(3)

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 */ 8 Sept 2000 11/14/2008 IPSEC_RANGETOSUBNET(3)
Related Man Pages
ipsec_initsubnet(3) - debian
ipsec_subnettypeof(3) - debian
ipsec_maskof(3) - centos
ipsec_rangetosubnet(3) - centos
ipsec_subnettypeof(3) - centos
Similar Topics in the Unix Linux Community
Is UNIX an open source OS ?
Introduction
Detecting unused variables...
A (ksh) Library For and From UNIX.com
New UNIX and Linux History Sections