| blob | dc3ea104c9b650eb1a1b20ffacf4e447d0b4853d |
1 .\"
2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
5 .\" 1.0 of the CDDL.
6 .\"
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source. A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
10 .\"
11 .\"
12 .\" Copyright (c) 2012, Joyent, Inc. All Rights Reserved
13 .\" Copyright (c) 2013 by Delphix. All rights reserved.
14 .\" Copyright 2014 Nexenta Systems, Inc. All rights reserved.
15 .\"
16 .Dd April 9, 2016
17 .Dt IPADM 1M
18 .Os
19 .Sh NAME
20 .Nm ipadm
21 .Nd configure IP interfaces, addresses and protocols
22 .Sh SYNOPSIS
23 .Nm
24 .Ic create-if
25 .Op Fl t
26 .Ar interface
27 .Nm
28 .Ic disable-if
29 .Fl t
30 .Ar interface
31 .Nm
32 .Ic enable-if
33 .Fl t
34 .Ar interface
35 .Nm
36 .Ic delete-if
37 .Ar interface
38 .Nm
39 .Ic show-if
40 .Op Oo Fl p Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
41 .Op Ar interface
42 .Nm
43 .Ic set-ifprop
44 .Op Fl t
45 .Fl p Ar prop Ns = Ns Ar value Ns Oo , Ns Ar value Oc Ns ...
46 .Fl m Ar protocol
47 .Ar interface
48 .Nm
49 .Ic reset-ifprop
50 .Op Fl t
51 .Fl p Ar prop
52 .Fl m Ar protocol
53 .Ar interface
54 .Nm
55 .Ic show-ifprop
56 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar value Oc Ns ...
57 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
58 .Op Fl m Ar protocol
59 .Op Ar interface
60 .Nm
61 .Ic create-addr
62 .Op Fl t
63 .Fl T Cm static
64 .Op Fl d
65 .Fl a Oo Cm local Ns | Ns Cm remote Ns = Oc Ns
66 .Ar addr Ns Oo / Ns Ar prefixlen Oc Ns ...
67 .Ar addrobj
68 .Nm
69 .Ic create-addr
70 .Op Fl t
71 .Fl T Cm dhcp
72 .Op Fl w Ar seconds Ns | Ns Cm forever
73 .Ar addrobj
74 .Nm
75 .Ic create-addr
76 .Op Fl t
77 .Fl T Cm addrconf
78 .Op Fl i Ar interface-id
79 .Oo Fl p Bro Cm stateful Ns | Ns Cm stateless Brc Ns = Ns
80 .Bro Cm yes Ns | Ns Cm no Brc Oc Ns ...
81 .Ar addrobj
82 .Nm
83 .Ic down-addr
84 .Op Fl t
85 .Ar addrobj
86 .Nm
87 .Ic up-addr
88 .Op Fl t
89 .Ar addrobj
90 .Nm
91 .Ic disable-addr
92 .Op Fl t
93 .Ar addrobj
94 .Nm
95 .Ic enable-addr
96 .Op Fl t
97 .Ar addrobj
98 .Nm
99 .Ic refresh-addr
100 .Op Fl i
101 .Ar addrobj
102 .Nm
103 .Ic delete-addr
104 .Op Fl r
105 .Ar addrobj
106 .Nm
107 .Ic show-addr
108 .Op Oo Fl p Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
109 .Op Ar addrobj
110 .Nm
111 .Ic set-addrprop
112 .Op Fl t
113 .Fl p Ar prop Ns = Ns Ar value Ns Oo , Ns Ar value Oc Ns ...
114 .Ar addrobj
115 .Nm
116 .Ic reset-addrprop
117 .Op Fl t
118 .Fl p Ar prop
119 .Ar addrobj
120 .Nm
121 .Ic show-addrprop
122 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
123 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
124 .Op Ar addrobj
125 .Nm
126 .Ic set-prop
127 .Op Fl t
128 .Fl p Ar prop Ns Oo Cm + Ns | Ns Cm - Oc Ns = Ns
129 .Ar value Ns Oo , Ns Ar value Oc Ns ...
130 .Ar protocol
131 .Nm
132 .Ic reset-prop
133 .Op Fl t
134 .Fl p Ar prop
135 .Ar protocol
136 .Nm
137 .Ic show-prop
138 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
139 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
140 .Op Ar protocol
141 .Sh DESCRIPTION
142 The
143 .Nm
144 command is a stable replacement for the
145 .Xr ifconfig 1M
146 and
147 .Xr ndd 1M
148 commands.
149 It is used to create IP interfaces and to configure IP addresses on those
150 interfaces.
151 It is also used to get, set or reset properties on interfaces, addresses and
152 protocols.
153 .Pp
154 For subcommands that take an
155 .Em addrobj ,
156 the
157 .Em addrobj
158 specifies a unique address on the system.
159 It is made up of two parts, delimited by a
160 .Sq / .
161 The first part is the name of the interface and the second part is a string up
162 to 32 characters long.
163 For example,
164 .Qq lo0/v4
165 is a loopback interface
166 .Em addrobj
167 name.
168 .Pp
169 For subcommands that take a
170 .Em protocol ,
171 this can be one of the following values:
172 .Cm ip ,
173 .Cm ipv4 ,
174 .Cm ipv6 ,
175 .Cm icmp ,
176 .Cm tcp ,
177 .Cm sctp
178 or
179 .Cm udp.
180 .Sh SUBCOMMANDS
181 The following subcommands are supported:
182 .Bl -tag -width ""
183 .It Xo
184 .Nm
185 .Ic create-if
186 .Op Fl t
187 .Ar interface
188 .Xc
189 Create an IP interface that will handle both IPv4 and IPv6 packets.
190 The interface will be enabled as part of the creation process.
191 The IPv4 interface will have the address 0.0.0.0.
192 The IPv6 interface will have the address ::.
193 .Bl -tag -width ""
194 .It Fl t Ns , Ns Fl -temporary
195 Temporary, not persistent across reboots.
196 .El
197 .It Xo
198 .Nm
199 .Ic disable-if
200 .Fl t
201 .Ar interface
202 .Xc
203 Disable an IP interface.
204 .Bl -tag -width ""
205 .It Fl t Ns , Ns Fl -temporary
206 Temporary, not persistent across reboots.
207 .El
208 .It Xo
209 .Nm
210 .Ic enable-if
211 .Fl t
212 .Ar interface
213 .Xc
214 Enable an IP interface.
215 .Bl -tag -width ""
216 .It Fl t Ns , Ns Fl -temporary
217 Temporary, not persistent across reboots.
218 .El
219 .It Xo
220 .Nm
221 .Ic delete-if
222 .Ar interface
223 .Xc
224 Permanently delete an IP interface.
225 .It Xo
226 .Nm
227 .Ic show-if
228 .Op Oo Fl p Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
229 .Op Ar interface
230 .Xc
231 Show the current IP interface configuration.
232 .Bl -tag -width ""
233 .It Fl o Ns , Ns Fl -output
234 Select which fields will be shown.
235 The field value can be one of the following names:
236 .Bl -tag -compact -width "PERSISTENT"
237 .It Cm ALL
238 Display all fields.
239 .It Cm IFNAME
240 The name of the interface.
241 .It Cm STATE
242 The state can be one of the following values:
243 .Bl -tag -compact -width "disabled"
244 .It Sy ok
245 resources for the interface have been allocated
246 .It Sy offline
247 the interface is offline
248 .It Sy failed
249 the interface's datalink is down
250 .It Sy down
251 the interface is down
252 .It Sy disabled
253 the interface is disabled
254 .El
255 .It Cm CURRENT
256 A set of single character flags indicating the following:
257 .Bl -tag -compact -width "b"
258 .It Sy b
259 broadcast (mutually exclusive with
260 .Sq p )
261 .It Sy m
262 multicast
263 .It Sy p
264 point-to-point (mutually exclusive with
265 .Sq b )
266 .It Sy v
267 virtual interface
268 .It Sy I
269 IPMP
270 .It Sy s
271 IPMP standby
272 .It Sy i
273 IPMP inactive
274 .It Sy V
275 VRRP
276 .It Sy a
277 VRRP accept mode
278 .It Sy 4
279 IPv4
280 .It Sy 6
281 IPv6
282 .El
283 .It Cm PERSISTENT
284 A set of single character flags showing what configuration will be used the
285 next time the interface is enabled:
286 .Bl -tag -compact -width "s"
287 .It Sy s
288 IPMP standby
289 .It Sy 4
290 IPv4
291 .It Sy 6
292 IPv6
293 .El
294 .El
295 .It Fl p Ns , Ns Fl -parsable
296 Print the output in a parsable format.
297 .El
298 .It Xo
299 .Nm
300 .Ic set-ifprop
301 .Op Fl t
302 .Fl p Ar prop Ns = Ns Ar value Ns Oo , Ns Ar value Oc Ns ...
303 .Fl m Ar protocol
304 .Ar interface
305 .Xc
306 Set a property's value(s) on the IP interface.
307 .Bl -tag -width ""
308 .It Fl m Ns , Ns Fl -module
309 Specify which protocol the setting applies to.
310 .It Fl p Ns , Ns Fl -prop
311 Specify the property name and value(s).
312 The property name can be one of the following:
313 .Bl -tag -compact -width "exchange_routes"
314 .It Cm arp
315 Address resolution protocol
316 .Pq Cm on Ns / Ns Cm off .
317 .It Cm exchange_routes
318 Exchange of routing data
319 .Pq Cm on Ns / Ns Cm off .
320 .It Cm forwarding
321 IP Forwarding
322 .Pq Cm on Ns / Ns Cm off
323 .It Cm metric
324 Set the routing metric to the numeric value.
325 The value is treated as extra hops to the destination.
326 .It Cm mtu
327 Set the maximum transmission unit to the numeric value.
328 .It Cm nud
329 Neighbor unreachability detection
330 .Pq Cm on Ns / Ns Cm off
331 .It Cm usesrc
332 Indicates which interface to use for source address selection.
333 A value
334 .Cm none
335 may also be used.
336 .El
337 .It Fl t Ns , Ns Fl -temporary
338 Temporary, not persistent across reboots.
339 .El
340 .It Xo
341 .Nm
342 .Ic reset-ifprop
343 .Op Fl t
344 .Fl p Ar prop
345 .Fl m Ar protocol
346 .Ar interface
347 .Xc
348 Reset an IP interface's property value to the default.
349 .Bl -tag -width ""
350 .It Fl m Ns , Ns Fl -module
351 Specify which protocol the setting applies to.
352 .It Fl p Ns , Ns Fl -prop
353 Specify the property name.
354 See the
355 .Nm ipadm Ic set-ifprop
356 subcommand for the list of property names.
357 .It Fl t Ns , Ns Fl -temporary
358 Temporary, not persistent across reboots.
359 .El
360 .It Xo
361 .Nm
362 .Ic show-ifprop
363 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar value Oc Ns ...
364 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
365 .Op Fl m Ar protocol
366 .Op Ar interface
367 .Xc
368 Display the property values for one or all of the IP interfaces.
369 .Bl -tag -width ""
370 .It Fl c Ns , Ns Fl -parsable
371 Print the output in a parsable format.
372 .It Fl m Ns , Ns Fl -module
373 Specify which protocol to display.
374 .It Fl o Ns , Ns Fl -output
375 Select which fields will be shown.
376 The field value can be one of the following names:
377 .Bl -tag -compact -width "PERSISTENT"
378 .It Cm ALL
379 Display all fields.
380 .It Cm IFNAME
381 The name of the interface.
382 .It Cm PROPERTY
383 The name of the property.
384 .It Cm PROTO
385 The name of the protocol.
386 .It Cm PERM
387 If the property is readable
388 .Pq Qq r
389 and/or writable
390 .Pq Qq w .
391 .It Cm CURRENT
392 The value of the property.
393 .It Cm PERSISTENT
394 The persistent value of the property.
395 .It Cm DEFAULT
396 The default value of the property.
397 .It Cm POSSIBLE
398 The possible values for the property.
399 .El
400 .It Fl p Ns , Ns Fl -prop
401 Specify which properties to display.
402 See the
403 .Nm ipadm Ic set-ifprop
404 subcommand for the list of property names.
405 .El
406 .It Xo
407 .Nm
408 .Ic create-addr
409 .Op Fl t
410 .Fl T Cm static
411 .Op Fl d
412 .Fl a Oo Cm local Ns | Ns Cm remote Ns = Oc Ns
413 .Ar addr Ns Oo / Ns Ar prefixlen Oc Ns ...
414 .Ar addrobj
415 .br
416 .Nm
417 .Ic create-addr
418 .Op Fl t
419 .Fl T Cm dhcp
420 .Op Fl w Ar seconds Ns | Ns Cm forever
421 .Ar addrobj
422 .br
423 .Nm
424 .Ic create-addr
425 .Op Fl t
426 .Fl T Cm addrconf
427 .Op Fl i Ar interface-id
428 .Oo Fl p Bro Cm stateful Ns | Ns Cm stateless Brc Ns = Ns
429 .Bro Cm yes Ns | Ns Cm no Brc Oc Ns ...
430 .Ar addrobj
431 .Xc
432 Create an address on an IP interface.
433 The address will be enabled but can disabled using the
434 .Nm ipadm Ic disable-addr
435 subcommand.
436 This subcommand has three different forms, depending on the value of the
437 .Fl T
438 option.
439 .Bl -tag -width ""
440 .It Fl T Cm static
441 Create a static addrobj.
442 Note that
443 .Cm addrconf
444 address configured on an interface is required to configure
445 .Cm static
446 IPv6 address on the same interface.
447 This takes the following options:
448 .Bl -tag -width ""
449 .It Fl a Ns , Ns Fl -address
450 Specify the address.
451 The
452 .Cm local
453 or
454 .Cm remote
455 prefix can be used for a point-to-point interface.
456 In this case, both addresses must be given.
457 Otherwise, the equal sign
458 .Pq Qq =
459 should be omitted and the address should be provided by itself without second
460 address.
461 .It Fl d Ns , Ns Fl -down
462 The address is down.
463 .El
464 .It Fl T Cm dhcp
465 Obtain the address via DHCP.
466 This takes the following options:
467 .Bl -tag -width ""
468 .It Fl w Ns , Ns Fl -wait
469 Specify the time, in seconds, that the command should wait to obtain an address.
470 .El
471 .It Fl T Cm addrconf
472 Create an auto-configured address.
473 This takes the following options:
474 .Bl -tag -width ""
475 .It Fl i Ns , Ns Fl -interface-id
476 Specify the interface ID to be used.
477 .It Fl p Ns , Ns Fl -prop
478 Specify which method of auto-configuration should be used.
479 .El
480 .It Fl t Ns , Ns Fl -temporary
481 Temporary, not persistent across reboots.
482 .El
483 .It Xo
484 .Nm
485 .Ic down-addr
486 .Op Fl t
487 .Ar addrobj
488 .Xc
489 Down the address.
490 This will stop packets from being sent or received.
491 .Bl -tag -width ""
492 .It Fl t Ns , Ns Fl -temporary
493 Temporary, not persistent across reboots.
494 .El
495 .It Xo
496 .Nm
497 .Ic up-addr
498 .Op Fl t
499 .Ar addrobj
500 .Xc
501 Up the address.
502 This will enable packets to be sent and received.
503 .Bl -tag -width ""
504 .It Fl t Ns , Ns Fl -temporary
505 Temporary, not persistent across reboots.
506 .El
507 .It Xo
508 .Nm
509 .Ic disable-addr
510 .Op Fl t
511 .Ar addrobj
512 .Xc
513 Disable the address.
514 .Bl -tag -width ""
515 .It Fl t Ns , Ns Fl -temporary
516 Temporary, not persistent across reboots.
517 .El
518 .It Xo
519 .Nm
520 .Ic enable-addr
521 .Op Fl t
522 .Ar addrobj
523 .Xc
524 Enable the address.
525 .Bl -tag -width ""
526 .It Fl t Ns , Ns Fl -temporary
527 Temporary, not persistent across reboots.
528 .El
529 .It Xo
530 .Nm
531 .Ic refresh-addr
532 .Op Fl i
533 .Ar addrobj
534 .Xc
535 Extend the lease for
536 .Sy DHCP
537 addresses.
538 It also restarts duplicate address detection for
539 .Cm static
540 addresses.
541 .Bl -tag -width ""
542 .It Fl i Ns , Ns Fl -inform
543 Obtain network configuration from DHCP without taking a lease on the address.
544 .El
545 .It Xo
546 .Nm
547 .Ic delete-addr
548 .Op Fl r
549 .Ar addrobj
550 .Xc
551 Delete the given address.
552 .Bl -tag -width ""
553 .It Fl r Ns , Ns Fl -release
554 Indicate that the DHCP-assigned address should be released.
555 .El
556 .It Xo
557 .Nm
558 .Ic show-addr
559 .Op Oo Fl p Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
560 .Op Ar addrobj
561 .Xc
562 Show the current address properties.
563 .Bl -tag -width ""
564 .It Fl o Ns , Ns Fl -output
565 Select which fields will be shown.
566 The field value can be one of the following names:
567 .Bl -tag -compact -width "PERSISTENT"
568 .It Cm ALL
569 Display all fields.
570 .It Cm ADDROBJ
571 The name of the address.
572 .It Cm TYPE
573 The type of the address
574 .Pq Sy static Ns / Ns Sy dhcp Ns / Ns Sy addrconf .
575 .It Cm STATE
576 The state of the address.
577 It can be one of the following values:
578 .Bl -tag -compact -width "inaccessible"
579 .It Sy disabled
580 see the
581 .Nm ipadm Ic disable-addr
582 subcommand
583 .It Sy down
584 see the
585 .Nm ipadm Ic down-addr
586 subcommand
587 .It Sy duplicate
588 the address is a duplicate
589 .It Sy inaccessible
590 the interface for this address has failed
591 .It Sy ok
592 the address is up
593 .It Sy tentative
594 duplicate address detection in progress
595 .El
596 .It Cm CURRENT
597 A set of single character flags indicating the following:
598 .Bl -tag -compact -width "U"
599 .It Sy U
600 up
601 .It Sy u
602 unnumbered
603 .Pq matches another local address
604 .It Sy p
605 private, not advertised to routing
606 .It Sy t
607 temporary IPv6 address
608 .It Sy d
609 deprecated
610 .Pq not used for outgoing packets
611 .El
612 .It Cm PERSISTENT
613 A set of single character flags showing the configuration which will be used
614 when the address is enabled.
615 .Bl -tag -compact -width "U"
616 .It Sy U
617 up
618 .It Sy p
619 private, not advertised to routing
620 .It Sy d
621 deprecated
622 .Pq not used for outgoing packets
623 .El
624 .It Cm ADDR
625 The address.
626 .El
627 .It Fl p Ns , Ns Fl -parsable
628 Print the output in a parsable format.
629 .El
630 .It Xo
631 .Nm
632 .Ic set-addrprop
633 .Op Fl t
634 .Fl p Ar prop Ns = Ns Ar value Ns Oo , Ns Ar value Oc Ns ...
635 .Ar addrobj
636 .Xc
637 Set a property's value(s) on the addrobj.
638 .Bl -tag -width ""
639 .It Fl p Ns , Ns Fl -prop
640 Specify the property name and value(s).
641 The property name can be one of the following:
642 .Bl -tag -compact -width "deprecated"
643 .It Cm broadcast
644 The broadcast address (read-only).
645 .It Cm deprecated
646 The address should not be used to send packets but can still receive packets
647 .Pq Cm on Ns / Ns Cm off .
648 .It Cm prefixlen
649 The number of bits in the IPv4 netmask or IPv6 prefix.
650 .It Cm private
651 The address is not advertised to routing
652 .Pq Cm on Ns / Ns Cm off .
653 .It Cm transmit
654 Packets can be transmitted
655 .Pq Cm on Ns / Ns Cm off .
656 .It Cm zone
657 The zone the addrobj is in.
658 .El
659 .It Fl t Ns , Ns Fl -temporary
660 Temporary, not persistent across reboots.
661 .El
662 .It Xo
663 .Nm
664 .Ic reset-addrprop
665 .Op Fl t
666 .Fl p Ar prop
667 .Ar addrobj
668 .Xc
669 Reset an addrobj's property value to the default.
670 .Bl -tag -width ""
671 .It Fl p Ns , Ns Fl -prop
672 Specify the property name.
673 See the
674 .Nm ipadm Ic set-addrprop
675 subcommand for the list of property names.
676 .It Fl t Ns , Ns Fl -temporary
677 Temporary, not persistent across reboots.
678 .El
679 .It Xo
680 .Nm
681 .Ic show-addrprop
682 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
683 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
684 .Op Ar addrobj
685 .Xc
686 Display the property values for one or all of the addrobjs.
687 .Bl -tag -width ""
688 .It Fl c Ns , Ns Fl -parsable
689 Print the output in a parsable format.
690 .It Fl o Ns , Ns Fl -output
691 Select which fields will be shown.
692 The field value can be one of the following names:
693 .Bl -tag -compact -width "PERSISTENT"
694 .It Cm ALL
695 Display all fields.
696 .It Cm ADDROBJ
697 The name of the addrobj.
698 .It Cm PROPERTY
699 The name of the property.
700 .It Cm PERM
701 If the property is readable
702 .Pq Qq r
703 and/or writable
704 .Pq Qq w .
705 .It Cm CURRENT
706 The value of the property.
707 .It Cm PERSISTENT
708 The persistent value of the property.
709 .It Cm DEFAULT
710 The default value of the property.
711 .It Cm POSSIBLE
712 The possible values for the property.
713 .El
714 .It Fl p Ns , Ns Fl -prop
715 Specify which properties to display.
716 See the
717 .Nm ipadm Ic set-addrprop
718 subcommand for the list of property names.
719 .El
720 .It Xo
721 .Ic set-prop
722 .Op Fl t
723 .Fl p Ar prop Ns Oo Cm + Ns | Ns Cm - Oc Ns = Ns
724 .Ar value Ns Oo , Ns Ar value Oc Ns ...
725 .Ar protocol
726 .Xc
727 Set a property's value(s) on the protocol.
728 .Bl -tag -width ""
729 .It Fl p Ns , Ns Fl -prop
730 Specify the property name and value(s).
731 The optional
732 .Sy + Ns | Ns Sy -
733 syntax can be used to add/remove values from the current list of values on the
734 property.
735 The property name can be one of the following:
736 .Bl -tag -compact -width "smallest_nonpriv_port"
737 .It Cm ecn
738 Explicit congestion control
739 .Pq Cm never Ns / Ns Cm passive Ns / Ns Cm active
740 .Pq TCP .
741 .It Cm extra_priv_ports
742 Additional privileged ports
743 .Pq SCTP/TCP/UDP .
744 .It Cm forwarding
745 Packet forwarding
746 .Pq Cm on Ns / Ns Cm off .
747 .It Cm hoplimit
748 The IPv6 hoplimit.
749 .It Cm largest_anon_port
750 Largest ephemeral port
751 .Pq SCTP/TCP/UDP .
752 .It Cm max_buf
753 Maximum receive or send buffer size
754 .Pq ICMP/SCTP/TCP/UDP .
755 This also sets the upper limit for the
756 .Cm recv_buf
757 and
758 .Cm send_buf
759 properties.
760 .It Cm recv_buf
761 Default receive buffer size
762 .Pq ICMP/SCTP/TCP/UDP .
763 The maximum value for this property is controlled by the
764 .Cm max_buf
765 property.
766 .It Cm sack
767 Selective acknowledgement
768 .Pq Cm active Ns / Ns Cm passive Ns / Ns Cm never
769 .Pq TCP .
770 .It Cm send_buf
771 Default send buffer size
772 .Pq ICMP/SCTP/TCP/UDP .
773 The maximum value for this property is controlled by the
774 .Cm max_buf
775 property.
776 .It Cm smallest_anon_port
777 Smallest ephemeral port
778 .Pq SCTP/TCP/UDP .
779 .It Cm smallest_nonpriv_port
780 Smallest non-privileged port
781 .Pq SCTP/TCP/UDP .
782 .It Cm ttl
783 The IPv4 time-to-live.
784 .El
785 .It Fl t Ns , Ns Fl -temporary
786 Temporary, not persistent across reboots.
787 .El
788 .It Xo
789 .Nm
790 .Ic reset-prop
791 .Op Fl t
792 .Fl p Ar prop
793 .Ar protocol
794 .Xc
795 Reset a protocol's property value to the default.
796 .Bl -tag -width ""
797 .It Fl p Ns , Ns Fl -prop
798 Specify the property name.
799 See the
800 .Nm ipadm Ic set-prop
801 subcommand for the list of property names.
802 .It Fl t Ns , Ns Fl -temporary
803 Temporary, not persistent across reboots.
804 .El
805 .It Xo
806 .Nm
807 .Ic show-prop
808 .Op Oo Fl c Oc Fl o Ar field Ns Oo , Ns Ar field Oc Ns ...
809 .Op Fl p Ar prop Ns Oo , Ns Ar prop Oc Ns ...
810 .Op Ar protocol
811 .Xc
812 Display the property values for one or all of the protocols.
813 .Bl -tag -width ""
814 .It Fl c Ns , Ns Fl -parsable
815 Print the output in a parsable format.
816 .It Fl o Ns , Ns Fl -output
817 Select which fields will be shown.
818 The field value can be one of the following names:
819 .Bl -tag -compact -width "PERSISTENT"
820 .It Cm ALL
821 Display all fields.
822 .It Cm PROTO
823 The name of the protocol.
824 .It Cm PROPERTY
825 The name of the property.
826 .It Cm PERM
827 If the property is readable
828 .Pq Qq r
829 and/or writable
830 .Pq Qq w .
831 .It Cm CURRENT
832 The value of the property.
833 .It Cm PERSISTENT
834 The persistent value of the property.
835 .It Cm DEFAULT
836 The default value of the property.
837 .It Cm POSSIBLE
838 The possible values for the property.
839 .El
840 .It Fl p Ns , Ns Fl -prop
841 Specify which properties to display.
842 See the
843 .Nm ipadm Ic set-prop
844 subcommand for the list of property names.
845 .El
846 .El
847 .Sh SEE ALSO
848 .Xr arp 1M ,
849 .Xr cfgadm 1M ,
850 .Xr dladm 1M ,
851 .Xr if_mpadm 1M ,
852 .Xr ifconfig 1M ,
853 .Xr ndd 1M ,
854 .Xr zonecfg 1M ,
855 .Xr nsswitch.conf 4 ,
856 .Xr dhcp 5