| Current File : //usr/share/man/man7p/if_tcp.7p |
'\" te
.\" Copyright (c) 2009, 2014, Oracle and/or its affiliates. All rights reserved.
.\" Copyright 1989 AT&T
.TH if_tcp 7P "28 Feb 2014" "SunOS 5.11" "Protocols"
.SH NAME
if_tcp, if \- general properties of Internet Protocol network interfaces
.SH DESCRIPTION
.sp
.LP
A network interface is a device for sending and receiving packets on a network. It is usually a hardware device, although it can be implemented in software. Network interfaces used by the Internet Protocol (IPv4 or IPv6) must be STREAMS devices conforming to the Data Link Provider Interface (\fBDLPI\fR). See \fBdlpi\fR(7P).
.SH APPLICATION PROGRAMMING INTERFACE
.sp
.LP
An interface becomes available to \fBIP\fR when it is opened and the \fBIP\fR module is pushed onto the stream with the \fBI_PUSH\fR \fBioctl\fR(2) command. (See \fBstreamio\fR(7I)). The \fBSIOCSLIFNAME\fR \fBioctl\fR(2) is issued to specify the name of the interface and to indicate whether it is IPv4 or IPv6. This can be initiated by the kernel at boot time or by a user program after the system is running. Each interface must be assigned an \fBIP\fR address with the \fBSIOCSLIFADDR\fR \fBioctl()\fR before it can be used. On interfaces where the network-to-link layer address mapping is static, only the network number is taken from the \fBioctl()\fR request; the remainder is found in a hardware specific manner. On interfaces which provide dynamic network-to-link layer address mapping facilities (for example, Ethernets using \fBarp\fR(7P)), the entire address specified in the \fBioctl()\fR is used. A routing table entry for destinations on the network of the interface is installed automatically when an interface's address is set.
.sp
.LP
You cannot create IPMP IP interfaces using the procedure described above. Instead, use \fBipadm\fR(1M) or \fBifconfig\fR(1M).
.SH IOCTLS
.sp
.LP
The following \fBioctl()\fR calls can be used to manipulate \fBIP\fR network interfaces. Unless specified otherwise, the request takes an \fBlifreq\fR structure as its parameter. This structure has the form:
.sp
.in +2
.nf
/*
/Structure required for ioctl SIOCCLIFFLAGS
*/
struct lif_cflags_req {
uint64_t lcr_modflags; /*flages to be modifited on if */
unit64_t lcr_modmask; /*mask of valid flages in lcr_modflags */
unit64_t lcr_origflags; /*expected initial flag values */
unit64_t lcr_origmask; /*mask of valid flags in lcr_origflags */
};
struct lifreq {
#define LIFNAMSIZ 32
char lifr_name[LIFNAMSIZ]; /* if name, e.g. "le1" */
union {
int lifru_addrlen; /* for subnet/token etc */
uint_t lifru_ppa; /* SIOCSLIFNAME */
} lifr_lifru1;
union {
struct sockaddr_storage lifru_addr;
struct sockaddr_storage lifru_dstaddr;
struct sockaddr_storage lifru_broadaddr;
struct sockaddr_storage lifru_token; /* With lifr_addrlen */
struct sockaddr_storage lifru_subnet; /* With lifr_addrlen */
int lifru_index; /* interface index */
uint64_t lifru_flags; /* SIOC?LIFFLAGS */
int lifru_metric;
uint_t lifru_mtu;
int lif_muxid[2]; /* mux id's for arp & ip */
struct lif_nd_req lifru_nd_req;
struct lif_ifinfo_req lifru_ifinfo_req;
zoneid_t lifru_zone; /* [GS]LIFZONE */
struct lif_cflags_req lifru_cflags_req; /*SIOCCLIFFLAGS*/
} lifr_lifru;
#define lifr_addrlen lifr_lifru1.lifru_addrlen
#define lifr_ppa lifr_lifru1.lifru_ppa /* Driver's ppa */
#define lifr_addr lifr_lifru.lifru_addr /* address */
#define lifr_dstaddr lifr_lifru.lifru_dstaddr
#define lifr_broadaddr lifr_lifru.lifru_broadaddr /* broadcast addr. */
#define lifr_token lifr_lifru.lifru_token /* address token */
#define lifr_subnet lifr_lifru.lifru_subnet /* subnet prefix */
#define lifr_index lifr_lifru.lifru_index /* interface index */
#define lifr_flags lifr_lifru.lifru_flags /* flags */
#define lifr_metric lifr_lifru.lifru_metric /* metric */
#define lifr_mtu lifr_lifru.lifru_mtu /* mtu */
#define lifr_ip_muxid lifr_lifru.lif_muxid[0]
#define lifr_arp_muxid lifr_lifru.lif_muxid[1]
#define lifr_nd lifr_lifru.lifru_nd_req /* LIF*ND */
#define lifr_ifinfo lifr_lifru.lifru_ifinfo_req /* [GS]LIFLNKINFO */
#define lifr_zone lifr_lifru.lifru_zone /* [GS]LIFZONE */
#define lifr_cflags lifr_lifru.lifru_cflags_req
};
.fi
.in -2
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFADDR\fR\fR
.ad
.sp .6
.RS 4n
Set interface address.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFADDR\fR\fR
.ad
.sp .6
.RS 4n
Get interface address.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFDSTADDR\fR\fR
.ad
.sp .6
.RS 4n
Set point to point address for interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFDSTADDR\fR\fR
.ad
.sp .6
.RS 4n
Get point to point address for interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFFLAGS\fR\fR
.ad
.sp .6
.RS 4n
Set interface flags field. If the interface is marked down, any processes currently routing packets through the interface are notified.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFFLAGS\fR\fR
.ad
.sp .6
.RS 4n
Get interface flags.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCCLIFFLAGS\fR\fR
.ad
.sp .6
.RS 4n
Change the given flags on the interface. The caller needs to fill in the fields \fBlcr_modflags\fR and \fBlcr_modmask\fR in \fBstruct lif_cflags_req\fR and optionally set \fBlcr_origflags\fR and \fBlcr_origmask\fR to fail the ioctl if any of the flags in \fBlcr_origflags\fR that are of interest to the caller do not match the current flags before applying the changes. This ioctl is preferred over \fBSIOCSLIFFLAGS\fR since the set and clear of the flags is done atomically unlike using \fBSIOCGLIFFLAGS\fR followed by \fBSIOCSLIFFLAGS\fR.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFCONF\fR\fR
.ad
.sp .6
.RS 4n
Get interface configuration list. This request takes a \fBlifconf\fR structure (see below) as a value-result parameter. The \fBlifc_family\fR field can be set to \fBAF_UNSPEC\fR to retrieve both \fBAF_INET\fR and \fBAF_INET6\fR interfaces. The \fBlifc_len\fR field should be set to the size of the buffer pointed to by \fBlifc_buf\fR.
.sp
The \fBlifc_flags\fR field should usually be set to zero, but callers that need low-level knowledge of the underlying IP interfaces that comprise an IPMP group can set it to \fBLIFC_UNDER_IPMP\fR to request that those interfaces be included in the result. Upon success, \fBlifc_len\fR contains the length, in bytes, of the array of \fBlifreq\fR structures pointed to by \fBlifc_req\fR. For each \fBlifreq\fR structure, the \fBlifr_name\fR and \fBlifr_addr\fR fields are valid.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFNUM\fR\fR
.ad
.sp .6
.RS 4n
Get number of interfaces. This request returns an integer which is the number of interface descriptions (\fBstruct lifreq\fR) returned by the \fBSIOCGLIFCONF\fR ioctl (in other words, indicates how large \fBlifc_len\fR must be).
.sp
This request takes a \fBstruct lifnum\fR (see below) as a value-result parameter. The \fBlifn_family\fR field can be set to \fBAF_UNSPEC\fR to count both \fBAF_INET\fR and \fBAF_INET6\fR interfaces. The \fBlifn_flags\fR field should usually be set to zero, but callers that need low-level knowledge of the underlying IP interfaces that comprise an IPMP group can set it to \fBLIFC_UNDER_IPMP\fR to request that those interfaces be included in the count.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFMTU\fR\fR
.ad
.sp .6
.RS 4n
Set the maximum transmission unit (MTU) size for interface. Place the request in the \fBlifru_mtu\fR field. The \fBMTU\fR can not exceed the physical \fBMTU\fR limitation (which is reported in the \fBDLPI\fR \fBDL_INFO_ACK\fR message).
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFMTU\fR\fR
.ad
.sp .6
.RS 4n
Get the maximum transmission unit size for interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFMETRIC\fR\fR
.ad
.sp .6
.RS 4n
Set the metric associated with the interface. The metric is used by routing daemons such as \fBin.routed\fR(1M).
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFMETRIC\fR\fR
.ad
.sp .6
.RS 4n
Get the metric associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFMUXID\fR\fR
.ad
.sp .6
.RS 4n
Get the \fBip\fR and \fBarp\fR \fBmuxid\fR associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFMUXID\fR\fR
.ad
.sp .6
.RS 4n
Set the \fBip\fR and \fBarp\fR \fBmuxid\fR associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFINDEX\fR\fR
.ad
.sp .6
.RS 4n
Get the interface index associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFINDEX\fR\fR
.ad
.sp .6
.RS 4n
Set the interface index associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFZONE\fR\fR
.ad
.sp .6
.RS 4n
Get the zone associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFZONE\fR\fR
.ad
.sp .6
.RS 4n
Set the zone associated with the interface. Only applies for zones that use the shared-IP instance.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCLIFADDIF\fR\fR
.ad
.sp .6
.RS 4n
Add a new logical interface on a physical interface using an unused logical interface number.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCLIFREMOVEIF\fR\fR
.ad
.sp .6
.RS 4n
Remove a logical interface by specifying its \fBIP\fR address or logical interface name.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFTOKEN\fR\fR
.ad
.sp .6
.RS 4n
Set the address token used to form IPv6 link-local addresses and for stateless address autoconfiguration.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFTOKEN\fR\fR
.ad
.sp .6
.RS 4n
Get the address token used to form IPv6 link-local addresses and for stateless address autoconfiguration.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFSUBNET\fR\fR
.ad
.sp .6
.RS 4n
Set the subnet prefix associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFSUBNET\fR\fR
.ad
.sp .6
.RS 4n
Get the subnet prefix associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFLNKINFO\fR\fR
.ad
.sp .6
.RS 4n
Set link specific parameters for the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFLNKINFO\fR\fR
.ad
.sp .6
.RS 4n
Get link specific parameters for the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCLIFDELND\fR\fR
.ad
.sp .6
.RS 4n
Delete a neighbor cache entry for IPv6.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCLIFGETND\fR\fR
.ad
.sp .6
.RS 4n
Get a neighbor cache entry for IPv6.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCLIFSETND\fR\fR
.ad
.sp .6
.RS 4n
Set a neighbor cache entry for IPv6.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSLIFUSESRC\fR\fR
.ad
.sp .6
.RS 4n
Set the interface from which to choose a source address. The \fBlifr_index\fR field has the interface index corresponding to the interface whose address is to be used as the source address for packets going out on the interface whose name is provided by \fBlifr_name\fR. If the \fBlifr_index\fR field is set to zero, the previous setting is cleared. See \fBipadm\fR(1M) for examples of the \fBusesrc\fR option.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFUSESRC\fR\fR
.ad
.sp .6
.RS 4n
Get the interface index of the interface whose address is used as the source address for packets going out on the interface provided by \fBlifr_name\fR field. The value is retrieved in the \fBlifr_index\fR field. See \fBipadm\fR(1M) for examples of the \fBusesrc\fR option.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFSRCOF\fR\fR
.ad
.sp .6
.RS 4n
Get the interface configuration list for interfaces that use an address hosted on the interface provided by the \fBlifs_ifindex\fR field in the \fBlifsrcof\fR struct (see below), as a source address. The application sets \fBlifs_maxlen\fR to the size (in bytes) of the buffer it has allocated for the data. On return, the kernel sets \fBlifs_len\fR to the actual size required. Note, the application could set \fBlifs_maxlen\fR to zero to query the kernel of the required buffer size instead of estimating a buffer size. The application tests \fBlifs_len\fR <= \fBlifs_maxlen\fR -- if that's true, the buffer was big enough and the application has an accurate list. If it is false, it needs to allocate a bigger buffer and try again, and \fBlifs_len\fR provides a hint of how big to make the next trial. See \fBipadm\fR(1M) for examples of the \fBusesrc\fR option.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCTONLINK\fR\fR
.ad
.sp .6
.RS 4n
Test if the address is directly reachable, for example, that it can be reached without going through a router. This request takes an \fBsioc_addrreq\fR structure (see below) as a value-result parameter. The \fBsa_addr\fR field should be set to the address to test. The \fBsa_res\fR field contains a non-zero value if the address is onlink.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCTMYADDR\fR\fR
.ad
.sp .6
.RS 4n
Test if the address is assigned to this node. This request takes an \fBsioc_addrreq\fR structure (see below) as a value-result parameter. The \fBsa_addr\fR field should be set to the address to test. The \fBsa_res\fR field contains a non-zero value if the address is assigned to this node.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCTMYSITE\fR\fR
.ad
.sp .6
.RS 4n
Test if the address is part of the same site as this node. This request takes an \fBsioc_addrreq\fR structure (see below) as a value-result parameter. The \fBsa_addr\fR field should be set to the address to test. The \fBsa_res\fR field contains a non-zero value if the address is in the same site.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGLIFHWADDR\fR\fR
.ad
.sp .6
.RS 4n
Retrieve the hardware address. For \fBPF_INET\fR and \fBPF_INET6\fR sockets, the name must refer to a network interface that is visible with \fBipadm\fR(1M). This ioctl can also be against \fBPF_PACKET\fR sockets for which the name must match an existing datalink reported by \fBdladm\fR(1M). A \fBsockaddr_dl\fR structure is filled out and returned in \fBlifr_addr\fR.
.RE
.sp
.LP
The structure used by \fBSIOCGLIFCONF\fR has the form:
.sp
.in +2
.nf
struct lifconf {
sa_family_t lifc_family;
int lifc_flags; /* request specific
/* interfaces */
int lifc_len; /* size of assoc. buffer */
union {
caddr_t lifcu_buf;
struct lifreq *lifcu_req;
} lifc_lifcu;
#define lifc_buf lifc_lifcu.lifcu_buf /* buffer address */
#define lifc_req lifc_lifcu.lifcu_req /* array of structs returned */
};
.fi
.in -2
.sp
.LP
The structure used by \fBSIOCGLIFNUM\fR has the form:
.sp
.in +2
.nf
struct lifnum {
sa_family_t lifn_family;
int lifn_flags; /* req. specf. interfaces */
int lifn_count; /* Result */
};
.fi
.in -2
.sp
.LP
The structure used by \fBSIOCTONLINK\fR, \fBSIOCTMYADDR\fR and \fBSIOCTMYSITE\fR has the form:
.sp
.in +2
.nf
struct sioc_addrreq {
struct sockaddr_storage sa_addr; /* Address to test */
int sa_res; /* Result - 0/1 */
};
.fi
.in -2
.sp
.LP
The structure used by \fBSIOCGLIFSRCOF\fR has the form:
.sp
.in +2
.nf
struct lifsrcof {
uint_t lifs_ifindex; /* addr on this interface */
/* used as the src addr */
size_t lifs_maxlen; /* size of buffer: input */
size_t lifs_len; /* size of buffer: output */
union {
caddr_t lifsu_buf;
struct lifreq *lifsu_req;
} lifs_lifsu;
#define lifs_buf lifs_lifsu.lifsu_buf /* buffer addr. */
#define lifs_req lifs_lifsu.lifsu_req /* array returned */
};
.fi
.in -2
.sp
.LP
The following \fBioctl()\fR calls are maintained for compatibility but only apply to IPv4 network interfaces, since the data structures are too small to hold an IPv6 address. Unless specified otherwise, the request takes an \fBifreq\fR structure as its parameter. This structure has the form:
.sp
.in +2
.nf
struct ifreq {
#define IFNAMSIZ 16
char ifr_name[IFNAMSIZ]; /* interface name - e.g. "hme0" */
union {
struct sockaddr ifru_addr;
struct sockaddr ifru_dstaddr;
struct sockaddr ifru_broadaddr;
short ifru_flags;
int ifru_metric;
int if_muxid[2]; /* mux id's for arp and ip */
int ifru_index; /* interface index */
} ifr_ifru;
#define ifr_addr ifr_ifru.ifru_addr /* address */
#define ifr_dstaddr ifr_ifru.ifru_dstaddr /*other end of p-to-p link*/
#define ifr_broadaddr ifr_ifru.ifru_broadaddr /* broadcast address */
#define ifr_flags ifr_ifru.ifru_flags /* flags */
#define ifr_index ifr_ifru.ifru_index /* interface index */
#define ifr_metric ifr_ifru.ifru_metric /* metric */
};
.fi
.in -2
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFADDR\fR\fR
.ad
.sp .6
.RS 4n
Set interface address.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFADDR\fR\fR
.ad
.sp .6
.RS 4n
Get interface address.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFDSTADDR\fR\fR
.ad
.sp .6
.RS 4n
Set point to point address for interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFDSTADDR\fR\fR
.ad
.sp .6
.RS 4n
Get point to point address for interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFFLAGS\fR\fR
.ad
.sp .6
.RS 4n
Set interface flags field. If the interface is marked down, any processes currently routing packets through the interface are notified.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFFLAGS\fR\fR
.ad
.sp .6
.RS 4n
Get interface flags.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFCONF\fR\fR
.ad
.sp .6
.RS 4n
Get interface configuration list. This request takes an \fBifconf\fR structure (see below) as a value-result parameter. The \fBifc_len\fR field should be set to the size of the buffer pointed to by \fBifc_buf\fR. Upon success, \fBifc_len\fR contains the length, in bytes, of the array of \fBifreq\fR structures pointed to by \fBifc_req\fR. For each \fBifreq\fR structure, the \fBifr_name\fR and \fBifr_addr\fR fields are valid. Though IPMP IP interfaces are included in the array, underlying IP interfaces that comprise those IPMP groups are not.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFNUM\fR\fR
.ad
.sp .6
.RS 4n
Get number of interfaces. This request returns an integer which is the number of interface descriptions (\fBstruct ifreq\fR) returned by the \fBSIOCGIFCONF\fR ioctl (in other words, indicates how large \fBifc_len\fR must be). Though IPMP IP interfaces are included in the array, underlying IP interfaces that comprise those IPMP groups are not.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFMTU\fR\fR
.ad
.sp .6
.RS 4n
Set the maximum transmission unit (\fBMTU\fR) size for interface. Place the request in the \fBifr_metric\fR field. The \fBMTU\fR has to be smaller than physical \fBMTU\fR limitation (which is reported in the \fBDLPI\fR \fBDL_INFO_ACK\fR message).
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFMTU\fR\fR
.ad
.sp .6
.RS 4n
Get the maximum transmission unit size for interface. Upon success, the request is placed in the \fBifr_metric\fR field.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFMETRIC\fR\fR
.ad
.sp .6
.RS 4n
Set the metric associated with the interface. The metric is used by routine daemons such as \fBin.routed\fR(1M).
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFMETRIC\fR\fR
.ad
.sp .6
.RS 4n
Get the metric associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFMUXID\fR\fR
.ad
.sp .6
.RS 4n
Get the \fBip\fR and \fBarp\fR \fBmuxid\fR associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFMUXID\fR\fR
.ad
.sp .6
.RS 4n
Set the \fBip\fR and \fBarp\fR \fBmuxid\fR associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFINDEX\fR\fR
.ad
.sp .6
.RS 4n
Get the interface index associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCSIFINDEX\fR\fR
.ad
.sp .6
.RS 4n
Set the interface index associated with the interface.
.RE
.sp
.ne 2
.mk
.na
\fB\fBSIOCGIFHWADDR\fR\fR
.ad
.sp .6
.RS 4n
Return the hardware address associated with the interface. See \fBSIOCGLIFHWADDR\fR for details on associations between names and sockets. This ioctl returns a \fBsockaddr\fR structure inside \fBifr_addr\fR and should behave in a manner compatible with Linux.
.RE
.sp
.LP
The \fBifconf\fR structure has the form:
.sp
.in +2
.nf
struct ifconf {
int ifc_len; /* size of assoc. buffer */
union {
caddr_t ifcu_buf;
struct ifreq *ifcu_req;
} ifc_ifcu;
#define ifc_buf ifc_ifcu.ifcu_buf /* buffer address */
#define ifc_req ifc_ifcu.ifcu_req /* array of structs returned */
};
.fi
.in -2
.SS "IFF_ Flags"
.sp
.LP
You can use the \fBipadm\fR command to display some of the \fBIFF\fR_ flags listed below (with the leading \fBIFF\fR_ prefix removed). See the \fBipadm\fR(1M) manual page for a definition of each flag.
.sp
.in +2
.nf
#define IFF_UP 0x0000000001 /* Address is up */
#define IFF_BROADCAST 0x0000000002 /* Broadcast address valid */
#define IFF_DEBUG 0x0000000004 /* Turn on debugging */
#define IFF_LOOPBACK 0x0000000008 /* Loopback net */
#define IFF_POINTOPOINT 0x0000000010 /* Interface is p-to-p */
#define IFF_NOTRAILERS 0x0000000020 /* Avoid use of trailers */
#define IFF_RUNNING 0x0000000040 /* Resources allocated */
#define IFF_NOARP 0x0000000080 /* No address res. protocol */
#define IFF_PROMISC 0x0000000100 /* Receive all packets */
#define IFF_ALLMULTI 0x0000000200 /* Receive all multicast pkts */
#define IFF_INTELLIGENT 0x0000000400 /* Protocol code on board */
#define IFF_MULTICAST 0x0000000800 /* Supports multicast */
#define IFF_MULTI_BCAST 0x0000001000 /* Multicast using broadcst. add*/
#define IFF_UNNUMBERED 0x0000002000 /* Non-unique address */
#define IFF_DHCPRUNNING 0x0000004000 /* DHCP controls interface */
#define IFF_PRIVATE 0x0000008000 /* Do not advertise */
#define IFF_NOXMIT 0x0000010000 /* Do not transmit pkts */
#define IFF_NOLOCAL 0x0000020000 /*No address;just on-link subnet*/
#define IFF_DEPRECATED 0x0000040000 /* Address is deprecated */
#define IFF_ADDRCONF 0x0000080000 /* Addr. from stateless addrconf*/
#define IFF_ROUTER 0x0000100000 /* Router on interface */
#define IFF_NONUD 0x0000200000 /* No NUD on interface */
#define IFF_ANYCAST 0x0000400000 /* Anycast address */
#define IFF_NORTEXCH 0x0000800000 /* Don't xchange rout. info */
#define IFF_IPV4 0x0001000000 /* IPv4 interface */
#define IFF_IPV6 0x0002000000 /* IPv6 interface */
#define IFF_NOFAILOVER 0x0008000000 /* in.mpathd test address */
#define IFF_FAILED 0x0010000000 /* Interface has failed */
#define IFF_STANDBY 0x0020000000 /* Interface is a hot-spare */
#define IFF_INACTIVE 0x0040000000 /* Functioning but not used */
#define IFF_OFFLINE 0x0080000000 /* Interface is offline */
#define IFF_COS_ENABLED 0x0200000000 /* If CoS marking is supported
#define IFF_COS_ENABLED 0x0200000000 /* If CoS marking is supported */
#define IFF_PREFERRED 0x0400000000 /* Prefer as source address */
#define IFF_TEMPORARY 0x0800000000 /* RFC3041 */
#define IFF_FIXEDMTU 0x1000000000 /* MTU set with SIOCSLIFMTU */
#define IFF_VIRTUAL 0x2000000000 /* Cannot send/receive pkts */
#define IFF_DUPLICATE 0x4000000000 /* Local address in use */
#define IFF_IPMP 0x8000000000 /* IPMP IP interface */
#define IFF_PHYSRUNNING 0x10000000000 /* physical connectivity to */
/* an external network */
#define IFF_VNI 0x200000000000ll /* VNI interface */
.fi
.in -2
.SH ERRORS
.sp
.ne 2
.mk
.na
\fB\fBEPERM\fR\fR
.ad
.RS 12n
.rt
Calling process has insufficient privileges.
.RE
.sp
.ne 2
.mk
.na
\fB\fBENXIO\fR\fR
.ad
.RS 12n
.rt
The \fBlifr_name\fR member of the \fBlifreq\fR structure contains an invalid value.
.sp
For \fBSIOCGLIFSRCOF\fR, the \fBlifs_ifindex\fR member of the \fBlifsrcof\fR structure contains an invalid value.
.sp
For \fBSIOCSLIFUSESRC\fR, this error is returned if the \fBlifr_index\fR is set to an invalid value.
.RE
.sp
.ne 2
.mk
.na
\fB\fBEBADADDR\fR\fR
.ad
.RS 12n
.rt
Wrong address family or malformed address.
.RE
.sp
.ne 2
.mk
.na
\fB\fBEINVAL\fR\fR
.ad
.RS 12n
.rt
For \fBSIOCSLIFMTU\fR, this error is returned when the requested \fBMTU\fR size is invalid. This error indicates the \fBMTU\fR size is greater than the \fBMTU\fR size supported by the \fBDLPI\fR provider or less than \fB68\fR (for IPv4) or less than \fB1280\fR (for IPv6).
.sp
For \fBSIOCSLIFUSESRC\fR, this error is returned if either the \fBlifr_index\fR or \fBlifr_name\fR identify interfaces that are already part of an existing IPMP group.
.RE
.sp
.ne 2
.mk
.na
\fB\fBEEXIST\fR\fR
.ad
.RS 12n
.rt
For \fBSIOCLIFADDIF\fR, this error is returned if the \fBlifr_name\fR member in the \fBlifreq\fR structure corresponds to an interface that already has the PPA specified by \fBlifr_ppa\fR plumbed.
.RE
.SH SEE ALSO
.sp
.LP
\fBdladm\fR(1M), \fBifconfig\fR(1M), \fBin.routed\fR(1M), \fBipadm\fR(1M), \fBioctl\fR(2), \fBipadm\fR(1M), \fBstreamio\fR(7I), \fBarp\fR(7P), \fBdlpi\fR(7P), \fBip\fR(7P), \fBip6\fR(7P)