ifcgtp(7P)

NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO

NAME

ifcgtp- general properties of CGTP network interfaces

DESCRIPTION

A CGTP network interface is a device for sending and receiving packets on redundant networks. It is a software device used by CGTP protocol.

IOCTLS

Use the following ioctl calls to manipulate CGTP network interfaces. The calling process must have superuser rights to successfully call these ioctls. Unless specified otherwise, the request takes a struct cgtp_ifreq structure as its parameter. This structure has the form:

struct cgtp_node {
				struct sockaddr addr;
				struct sockaddr rlinks[CGTP_MAX_LINKS];
};
struct cgtp_ifreq {
				struct ifreq ifr;
				struct cgtp_node node;
};

---

Note -

Interface request used for socket ioctls. All interface ioctls must have parameter definitions which begin with ifr_name

---

To call these ioctls, a standard socket must be created:

int fd = socket(PF_INET, SOCK_DGRAM, 0);

The SIOCSLIFNAME ioctl() is used to specify the name of the interface. This is initiated by the microkernel at boot time or by a user program when the system is already running. Each interface must be assigned an IP address with the SIOCLIFADDR ioctl() before it can be used.

SIOCSIFADDNODE

Register a new node in CGTP, i.e. new n-uplets composed of one CGTP IP address (the IP address of the cluster node), and a list of redundant links IP addresses. The number of redundant links is fixed at two. Entries that are not used must be filled with the loopback Internet address.

SIOCSIFDELNODE

Unregister a cluster node from CGTP. The parameter passed to the ioctl() contains a structure holding the Internet address of the CGTP cluster node.

SIOCSIFDISCNODE

Break each TCP connection involving, on the local node, a given CGTP cluster node. The parameter passed to the ioctl() contains an in_addr structure holding the Internet address of the CGTP cluster node. When the parameter is received, this ioctl() brings about the search of affected connections at the ifnet level. When the connections are found they are all disconnected.

ERRORS

EADDRINUSE

The cluster node is already registered.

EADDRNOTAVAIL

There is no cluster node registered under the specified Internet address.

EAFNOSUPPORT

The ifnet family of the node is not AF_INET

EDQUOT

At least one route contains a loop

EHOSTUNREACH

At least one route is not created

ENOMEM

There is not enough memory in the system to record the new cluster node

EPERM

Permission to use the ioctl is denied

EINVAL

Invalid parameters

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-level	MT-safe

SEE ALSO

ifconfig(1M), ioctl(2POSIX)

ChorusOS 5.0  Last Revised December 2001

NAME | DESCRIPTION | ATTRIBUTES | SEE ALSO