JavaScript is required to for searching.
ナビゲーションリンクをスキップ
印刷ビューの終了
マニュアルページセクション 1M: システム管理コマンド     Oracle Solaris 11.1 Information Library (日本語)
このドキュメントの評価
search filter icon
search icon

ドキュメントの情報

はじめに

紹介

System Administration Commands - パート 1

6to4relay(1M)

acct(1M)

acctadm(1M)

acctcms(1M)

acctcon1(1M)

acctcon(1M)

acctcon2(1M)

acctdisk(1M)

acctdusg(1M)

acctmerg(1M)

accton(1M)

acctprc1(1M)

acctprc(1M)

acctprc2(1M)

acctsh(1M)

acctwtmp(1M)

acpihpd(1M)

adbgen(1M)

add_allocatable(1M)

addbadsec(1M)

add_drv(1M)

aimanifest(1M)

arp(1M)

asradm(1M)

asr-notify(1M)

atohexlabel(1M)

audit(1M)

auditconfig(1M)

auditd(1M)

auditrecord(1M)

auditreduce(1M)

auditstat(1M)

audit_warn(1M)

automount(1M)

automountd(1M)

autopush(1M)

bart(1M)

beadm(1M)

boot(1M)

bootadm(1M)

bootconfchk(1M)

bootparamd(1M)

busstat(1M)

captoinfo(1M)

catman(1M)

cfgadm(1M)

cfgadm_ac(1M)

cfgadm_cardbus(1M)

cfgadm_fp(1M)

cfgadm_ib(1M)

cfgadm_pci(1M)

cfgadm_sata(1M)

cfgadm_sbd(1M)

cfgadm_scsi(1M)

cfgadm_sdcard(1M)

cfgadm_shp(1M)

cfgadm_sysctrl(1M)

cfgadm_usb(1M)

chargefee(1M)

chat(1M)

check-hostname(1M)

check-permissions(1M)

chk_encodings(1M)

chroot(1M)

cimworkshop(1M)

ckpacct(1M)

clear_locks(1M)

clinfo(1M)

closewtmp(1M)

clri(1M)

comsat(1M)

configCCR(1M)

consadm(1m)

console-reset(1M)

coreadm(1M)

cpustat(1M)

croinfo(1M)

cron(1M)

cryptoadm(1M)

datadm(1M)

dcopy(1M)

dcs(1M)

dd(1M)

ddu(1M)

ddu-text(1M)

devchassisd(1M)

devfsadm(1M)

devfsadmd(1M)

device_allocate(1M)

device_remap(1M)

devinfo(1M)

devlinks(1M)

devnm(1M)

devprop(1M)

df(1M)

dfmounts(1M)

dfmounts_nfs(1M)

dfshares(1M)

dfshares_nfs(1M)

df_ufs(1M)

dhcpagent(1M)

dhcpconfig(1M)

dhcpmgr(1M)

dhtadm(1M)

dig(1M)

directoryserver(1M)

diskinfo(1M)

disks(1M)

diskscan(1M)

dispadmin(1M)

distro_const(1M)

dladm(1M)

dlmgmtd(1M)

dlstat(1M)

dmesg(1M)

dminfo(1M)

dns-sd(1M)

dnssec-dsfromkey(1M)

dnssec-keyfromlabel(1M)

dnssec-keygen(1M)

dnssec-makekeyset(1M)

dnssec-signkey(1M)

dnssec-signzone(1M)

dodisk(1M)

domainname(1M)

drd(1M)

drvconfig(1M)

dsbitmap(1M)

dscfg(1M)

dscfgadm(1M)

dscfglockd(1M)

dsstat(1M)

dsvclockd(1M)

dtrace(1M)

dumpadm(1M)

editmap(1M)

edquota(1M)

eeprom(1M)

efdaemon(1M)

embedded_su(1M)

emCCR(1M)

emocmrsp(1M)

etrn(1M)

fbconfig(1M)

fbconf_xorg(1M)

fcadm(1M)

fcinfo(1M)

fdetach(1M)

fdisk(1M)

ff(1M)

ff_ufs(1M)

fingerd(1M)

fiocompress(1M)

flowadm(1M)

flowstat(1M)

fmadm(1M)

fmd(1M)

fmdump(1M)

fmstat(1M)

fmthard(1M)

format(1M)

fruadm(1M)

fsck(1M)

fsck_pcfs(1M)

fsck_udfs(1M)

fsck_ufs(1M)

fsdb(1M)

fsdb_udfs(1M)

fsdb_ufs(1M)

fsflush(1M)

fsirand(1M)

fssnap(1M)

fssnap_ufs(1M)

fsstat(1M)

fstyp(1M)

fuser(1M)

fwflash(1M)

fwtmp(1M)

getdevpolicy(1M)

getent(1M)

gettable(1M)

getty(1M)

gkadmin(1M)

groupadd(1M)

groupdel(1M)

groupmod(1M)

growfs(1M)

grpck(1M)

gsscred(1M)

gssd(1M)

hald(1M)

hal-device(1M)

hal-fdi-validate(1M)

hal-find(1M)

hal-find-by-capability(1M)

hal-find-by-property(1M)

hal-get-property(1M)

hal-set-property(1M)

halt(1M)

hextoalabel(1M)

host(1M)

hostconfig(1M)

hotplug(1M)

hotplugd(1M)

htable(1M)

ickey(1M)

id(1M)

idmap(1M)

idmapd(1M)

idsconfig(1M)

ifconfig(1M)

if_mpadm(1M)

ifparse(1M)

iiadm(1M)

iicpbmp(1M)

iicpshd(1M)

ikeadm(1M)

ikecert(1M)

ilbadm(1M)

ilbd(1M)

ilomconfig(1M)

imqadmin(1M)

imqbrokerd(1M)

imqcmd(1M)

imqdbmgr(1M)

imqkeytool(1M)

imqobjmgr(1M)

imqusermgr(1M)

in.chargend(1M)

in.comsat(1M)

in.daytimed(1M)

in.dhcpd(1M)

in.discardd(1M)

in.echod(1M)

inetadm(1M)

inetconv(1M)

inetd(1M)

in.fingerd(1M)

infocmp(1M)

in.iked(1M)

init(1M)

init.sma(1M)

init.wbem(1M)

inityp2l(1M)

in.lpd(1M)

in.mpathd(1M)

in.named(1M)

in.ndpd(1M)

in.rarpd(1M)

in.rdisc(1M)

in.rexecd(1M)

in.ripngd(1M)

in.rlogind(1M)

in.routed(1M)

in.rshd(1M)

in.rwhod(1M)

install(1M)

installadm(1M)

installboot(1M)

installf(1M)

installgrub(1M)

in.stdiscover(1M)

in.stlisten(1M)

in.talkd(1M)

in.telnetd(1M)

in.tftpd(1M)

in.timed(1M)

intrd(1M)

intrstat(1M)

in.uucpd(1M)

iostat(1M)

ipaddrsel(1M)

ipadm(1M)

ipf(1M)

ipfs(1M)

ipfstat(1M)

ipmgmtd(1M)

ipmon(1M)

ipmpstat(1M)

ipnat(1M)

ippool(1M)

ipqosconf(1M)

ipsecalgs(1M)

ipsecconf(1M)

ipseckey(1M)

iscsiadm(1M)

isns(1M)

isnsadm(1M)

itadm(1M)

itu(1M)

js2ai(1M)

k5srvutil(1M)

kadb(1M)

kadmin(1M)

kadmind(1M)

kadmin.local(1M)

kcfd(1M)

kclient(1M)

kdb5_ldap_util(1M)

kdb5_util(1M)

kdcmgr(1M)

kernel(1M)

keyserv(1M)

killall(1M)

kmem_task(1M)

kmscfg(1M)

kprop(1M)

kpropd(1M)

kproplog(1M)

krb5kdc(1M)

ksslcfg(1M)

kstat(1M)

ktkt_warnd(1M)

labeld(1M)

labelit(1M)

labelit_hsfs(1M)

labelit_udfs(1M)

labelit_ufs(1M)

lastlogin(1M)

latencytop(1M)

ldapaddent(1M)

ldap_cachemgr(1M)

ldapclient(1M)

ldmad(1M)

link(1M)

llc2_loop(1M)

lldpadm(1M)

lldpd(1M)

lms(1M)

locator(1M)

lockd(1M)

lockfs(1M)

lockstat(1M)

lofiadm(1M)

logadm(1M)

logins(1M)

lshal(1M)

System Administration Commands - パート 2

System Administration Commands - パート 3

ドキュメントの品質向上のためのご意見をください
簡潔すぎた
読みづらかった、または難し過ぎた
重要な情報が欠けていた
内容が間違っていた
翻訳版が必要
その他
Your rating has been updated
貴重なご意見を有り難うございました!

あなたの貴重なご意見はより良いドキュメント作成の手助けとなります 内容の品質向上と追加コメントのためのアンケートに参加されますか?

ipadm

- インターネットプロトコルネットワークインタフェースおよび TCP/IP 調整可能パラメータの構成

形式

ipadm
ipadm create-ip [-t] IP-interface
ipadm delete-ip IP-interface
ipadm create-vni [-t] VNI-interface
ipadm delete-vni VNI-interface
ipadm create-ipmp [-t] [-i interface,[...]...] IPMP-interface
ipadm delete-ipmp [-f] IPMP-interface
ipadm add-ipmp [-t] -i interface,[...] [-i interface,[...]...]
     IPMP-interface
ipadm remove-ipmp [-t] -i interface,[...] [-i interface,[...]...]
     IPMP-interface
ipadm show-if [[-p] -o field[,...]] [interface]
ipadm disable-if -t interface
ipadm enable-if -t interface
ipadm set-ifprop [-t] -m protocol -p prop=value[,...] interface
ipadm reset-ifprop [-t] -m protocol -p prop interface
ipadm show-ifprop [[-c] -o field[,...]] [-p prop,...]
     [-m protocol] [interface]
ipadm create-addr [-t] [-T static] [-d]
     -a {local|remote}=addr[/prefixlen],... addrobj | interface
ipadm create-addr [-t] -T dhcp [-w seconds | forever]
     [-h hostname] addrobj | interface
ipadm create-addr [-t] -T addrconf [-i {local|remote}=interface-id]
     [-p {stateful|stateless}={yes|no},..] addrobj | interface
ipadm delete-addr [-r] addrobj
ipadm show-addr [[-p] -o field[,...]] [-d]
     [addrobj | interface/ | interface]
ipadm up-addr [-t] addrobj
ipadm down-addr [-t] addrobj
ipadm refresh-addr [-i] addrobj
ipadm disable-addr -t addrobj
ipadm enable-addr -t addrobj
ipadm set-addrprop [-t] -p prop=value[,...] addrobj
ipadm reset-addrprop [-t] -p prop=value[,...] addrobj
ipadm show-addrprop [[-c] -o field[,...]] [-p prop[,...]]
     [addrobj | interface]
ipadm set-prop [-t] -p prop=value[,...] protocol
ipadm reset-prop [-t] -p prop protocol
ipadm show-prop [[-c] -o field[,...]] [-p prop[,...] protocol | protocol]
ipadm help [subcommand-name]

機能説明

ipadm コマンドには一連のサブコマンドがあり、次の目的に使用できます。

インタフェースを管理する:
  • インタフェースクラス ipipmp、および vni のインタフェースを作成および削除する

  • インタフェースのプロパティーを変更する

  • インタフェースの構成を表示する

アドレスを管理する:
  • アドレスを作成および削除する

  • アドレスのプロパティーを変更する

  • アドレスの構成を表示する

TCP/IP プロトコルのプロパティーを管理する:
  • TCP/IP のプロパティーを変更する

  • TCP/IP のプロパティーを表示する

ipadm は、ネットワーク構成を手動で管理するために使用します。これらの手動構成では、netadm(1M) の DefaultFixed NCP を有効にするようにしてください。ipadm のサブコマンドの多くは、DefaultFixed NCP が有効になっていないと機能しません。DefaultFixed NCP が有効になっていないと機能しない ipadm のサブコマンドは次のとおりです。

create-ipdelete-ipcreate-vnidelete-vnicreate-ipmpdelete-ipmpadd-ipmpremove-ipmpdisable-ifenable-ifset-ifpropreset-ifpropcreate-addrdown-addrup-addrdisable-addrenable-addrrefresh-addrdelete-addrset-addrpropreset-addrprop

次のサブコマンドは、DefaultFixed NCP が有効になっていなくても機能します。

show-ifshow-ifproprefresh-addrshow-addrshow-addrpropset-propreset-propshow-prop

NCP を一覧表示して有効にする方法の詳細は、netadm(1M) を参照してください。

ipadm サブコマンドのさまざまなオペランドについては、「サブコマンド」に続く「オペランド」の項で説明されています。

サブコマンドなしの ipadm コマンドは、システムでのインタフェースおよびアドレス構成の簡単なサマリーを表示します。出力には、システムで構成されているすべてのインタフェース (iploopbackvni、および ipmp)、およびこれらのインタフェースで構成されているアドレスが含まれます。詳しくは、次の EXAMPLES を参照してください。

必要な承認と特権

次のサブコマンドには、solaris.network.interface.config 承認と PRIV_SYS_IP_CONFIG 特権が必要です。

create-ip          create-addr
delete-ip          up-addr
create-vni         down-addr
delete-vni         refresh-addr
create-ipmp        disable-addr
delete-ipmp        enable-addr
add-ipmp           set-addrprop
remove-ipmp        reset-addrprop
disable-if         set-prop
enable-if          reset-prop
set-ifprop
reset-ifprop

前述の承認と特権に加えて、ipadm のサブコマンドの create-ipcreate-vnicreate-ipmp、および enable-if には PRIV_NET_RAWACCESS 特権も必要です。

サブコマンド

サポートされているサブコマンドは次のとおりです。

create-ip [-t] IP-interface

IPv4 パケットと IPv6 パケットの両方を処理する IP インタフェースを作成します。IPv4 インタフェースのアドレスは 0.0.0.0 に設定され、IPv6 インタフェースのアドレスは :: に設定されます。デフォルトでは、このサブコマンドの情報は持続し、次回のリブート時にこのインタフェースがインスタンス化されます。

インタフェースの作成時には、IPv4 と IPv6 の両方が暗黙的に有効になっています。インタフェースの無効化および有効化については、後述の disable-if サブコマンドと enable-if サブコマンドを参照してください。

lo0 は、ループバックインタフェースと呼ばれる特殊なインタフェースです。これは仮想 IP インタフェースなので、どの物理ハードウェアにも関連付けられません。これはシステムに最初に作成される IP インタフェースの 1 つであり、その IPv4 アドレスは 127.0.0.1、IPv6 アドレスは ::/128 です。

-t, --temporary

これは一時的な操作で、永続してはいけないことを示します。操作の影響を受けるのはアクティブな構成だけです。

delete-ip IP-interface

この IP インタフェースをアクティブな構成から削除します。このインタフェースに構成されているすべてのアドレスが破棄されます。さらに、インタフェースに関連するすべての永続的な情報が永続的データストアから削除されるため、リブート時に interface はインスタンス化されません。アクティブな構成からインタフェースを (削除するのではなく) 無効にするには、disable-if サブコマンドを使用します。

create-vni [-t] VNI-interface

IPv4 パケットと IPv6 パケットの両方を処理する VNI インタフェースを作成します。IPv4 インタフェースのアドレスは 0.0.0.0 に設定され、IPv6 インタフェースのアドレスは :: に設定されます。デフォルトでは、このサブコマンドの情報は持続し、次回のリブート時にこのインタフェースがインスタンス化されます。

インタフェースの作成時には、IPv4 と IPv6 の両方が暗黙的に有効になっています。インタフェースの無効化および有効化については、後述の disable-if サブコマンドと enable-if サブコマンドを参照してください。

仮想インタフェースなのでどのハードウェアにも関連付けられないという点で、vni は特殊なインタフェースです。vni(7d) を参照してください。

-t, -—temporary

これは一時的な操作で、永続してはいけないことを示します。操作の影響を受けるのはアクティブな構成だけです。

delete-vni VNI-interface

この VNI インタフェースをアクティブな構成から削除します。このインタフェースに構成されているすべてのアドレスが破棄されます。さらに、IP インタフェースに関連するすべての永続的な情報が永続的データストアから削除されるため、リブート時に interface はインスタンス化されません。アクティブな構成からインタフェースを (削除するのではなく) 無効にするには、disable-if サブコマンドを使用します。

create-ipmp [-t] [-i interface,[...]...] IPMP-interface

IPv4 パケットと IPv6 パケットの両方を処理する IPMP インタフェースを作成します。IPv4 インタフェースのアドレスは 0.0.0.0 に設定され、IPv6 インタフェースのアドレスは :: に設定されます。デフォルトでは、このサブコマンドの情報は持続し、次回のリブート時にこのインタフェースがインスタンス化されます。

インタフェースの作成時には、IPv4 と IPv6 の両方が暗黙的に有効になっています。IPMP インタフェースの無効化および有効化については、後述の disable-if サブコマンドと enable-if サブコマンドを参照してください。

-t, -—temporary

これは一時的な操作で、永続してはいけないことを示します。操作の影響を受けるのはアクティブな構成だけです。

-i, -—interface interface,[...]

基になるインタフェースとして IPMP インタフェースに追加するインタフェースのコンマ区切りのリスト。インタフェースを IPMP グループに正常に追加するには、これらのインタフェースはアクティブな構成に存在している必要があり、ほかの IPMP グループに属していてはいけません。-i オプションは複数指定できます。IPMP インタフェースは作成されたが、指定された基になるインタフェースが 1 つも正常に追加されなかった場合、このコマンドは部分的な成功を返します。

delete-ipmp [-f] IPMP-interface

この IPMP インタフェースをアクティブな構成から削除します。このインタフェースに構成されているすべてのアドレスが破棄されます。IPMP インタフェースに基になるインタフェースが存在している場合、-f オプションを指定しないと、このコマンドは失敗します。さらに、IPMP インタフェースに関連するすべての永続的な情報が永続的データストアから削除されるため、リブート時に interface はインスタンス化されません。アクティブな構成からインタフェースを (削除するのではなく) 単に無効にするには、disable-if サブコマンドを使用します。

-f, --force

IPMP インタフェースに基になるインタフェースが存在している場合、このオプションを指定すると、基になるインタフェースがすべてグループから削除されたあと、IPMP インタフェースが削除されます。

add-ipmp [-t] -i interface,[...] [-i interface,[...]...] IPMP-interface

指定された IPMP インタフェースに 1 つまたは複数の基になる IP インタフェースを追加します。

-t, -—temporary

これは一時的な操作で、永続してはいけないことを示します。操作の影響を受けるのはアクティブな構成だけです。

-i, -—interface interface,[...]

基になるインタフェースとして IPMP インタフェースに追加するインタフェースのコンマ区切りのリスト。インタフェースを IPMP グループに正常に追加するには、これらのインタフェースはアクティブな構成に存在している必要があり、ほかの IPMP グループに属していてはいけません。少なくとも 1 つのインタフェースは追加されたが、残りのインタフェースは追加に失敗した場合、このコマンドは部分的な成功を返します。-i オプションは複数指定できます。

remove-ipmp [-t] -i interface,[...] [-i interface,[...]...] IPMP-interface

この IPMP インタフェースから 1 つまたは複数の基になる IP インタフェースを削除します。

-t, -—temporary

これは一時的な操作で、永続してはいけないことを示します。操作の影響を受けるのはアクティブな構成だけです。

-i, -—interface interface,[...]

IPMP インタフェースから削除する基になるインタフェースのコンマ区切りのリスト。指定するインタフェースは、この IPMP グループの基になるインタフェースとしてすでに設定されている必要があります。-i オプションは複数指定できます。少なくとも 1 つのインタフェースは削除されたが、残りのインタフェースは削除に失敗した場合、このコマンドは部分的な成功を返します。

show-if [[-p] -o field[,...]] [interface]

ネットワークインタフェースの構成情報を表示します。システム上に構成されているすべてのネットワークインタフェース (永続的な構成だけに存在するものも含む) を対象にすることも、特定のネットワークインタフェースを対象にすることもできます。

-o field[,...], --output field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。field 名には、次に示すフィールドのいずれか、あるいは、すべてのフィールドを表示するための特殊な値 all を指定する必要があります。各ネットワークインタフェースについて、次のフィールドを表示できます。

IFNAME

IP インタフェースの名前。

CLASS

次のうちのいずれかを指定します。

ip

基になるデータリンク上に plumb されたインタフェース。

ipmp

1 つまたは複数の基になる IP インタフェース上に作成された IPMP インタフェース。

loopback

ループバックインタフェース。

vni

仮想 IP インタフェース。vni(7d) を参照してください。

STATE

表示されるインタフェースに関して、次のいずれかを示します。

ok

インタフェースが必要とするリソースが確保されていることを示します。一部のインタフェースでは、これは、リンクが稼働していることも示します。

offline

インタフェースはオフライン状態なので、IP データトラフィックを送受信できません。if_mpadm(1M) を参照してください。

failed

データリンクが停止していることを示します。インタフェースが IPMP グループに属している場合、これは、インタフェースに障害が発生している (つまり、IFF_FAILED が設定されている) ことも示すことがあります。障害が発生したインタフェースは、IP データトラフィックの送受信には使用されません。これが IPMP グループの物理 IP インタフェースに設定されている場合、IP データトラフィックは、その IPMP グループで使用可能なほかの IP インタフェースを介して引き続き送受信されます。これが IPMP IP インタフェースに設定されている場合は、グループ全体が障害状態であり、そのグループのどのインタフェースでもデータトラフィックを送受信できません。in.ndpd(1M) を参照してください。

down

そのインタフェースを介して IP パケットが送受信されないように、インタフェースが管理上停止されていることを示します。

disabled

インタフェースが disable-if サブコマンドによってアクティブな構成から無効にされていることを示します。

ACTIVE

その IP インタフェースがシステムで IP データトラフィックに使用されているかどうかによって、yes または no になります。

CURRENT

アクティブな構成のインタフェースオブジェクトに関して、次のフラグのいずれかを示します。

b

インタフェースはブロードキャストをサポートしています

m

インタフェースはマルチキャストをサポートしています

p

インタフェースはポイントツーポイントリンクです

v

インタフェースは仮想インタフェースです (vni(7d)、ループバックなど)。つまり、物理インタフェースには基になるハードウェアがありません。

s

IPMP インタフェースは、管理上 standby としてマークされています。in.ndpd(1M) を参照してください。

l

インタフェースは、IPMP インタフェースの基になるインタフェースです。in.ndpd(1M) を参照してください。

i

基になるインタフェースはアクティブではありません。in.ndpd(1M) を参照してください。

V

インタフェースは VRRP インタフェースです

a

VRRP インタフェースはアクセプトモードです (~IFF_NOACCEPT)

Z

インタフェースの IP アドレスのレイヤー 3 保護が管理上適用されています。

4

インタフェースは IPv4 パケットを処理できます

6

インタフェースは IPv6 パケットを処理できます

bp を同時に指定することはできません。

PERSISTENT

インタフェースオブジェクトがリブート時にインスタンス化されるとき、または enable-if サブコマンドで再度有効化されるときに適用する構成を指定します。sl4、および 6 の任意の組み合わせにできます (前述の説明を参照)。このフィールドはデフォルトでは表示されず、-oall または persistent を指定した場合のみ表示されます。

OVER

IPMP インタフェースが作成される基になるインタフェース。これは、ほかのインタフェースクラスには適用されません。

-p, --parsable

安定したマシン解析可能な形式を使用して表示します。このオプションには -o オプションが必要です。下記の「解析可能な出力形式」を参照してください。

disable-if -t interface

指定された interface をアクティブな構成から削除することによって無効にします。このインタフェースに構成されているすべてのアドレスが無効になります。もともと永続的なインタフェースオブジェクトとして作成されていた場合、永続的な構成は変更されません。このインタフェースを再度有効にするには、enable-if を使用するようにしてください。

-t, --temporary

この無効化は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

enable-if -t interface

構成を永続的ストアから読み取ることで、指定されたインタフェースを有効にします。永続的なインタフェースプロパティーがあればすべて適用され、指定されたインタフェースに永続的アドレスがあればすべて有効になります。

-t, --temporary

この有効化は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

set-ifprop [-t] -m protocol -p prop=value[,...] interface

インタフェースのプロパティーを、ユーザーが指定した値に変更します。プロパティーが複数の値を取る場合は、区切り文字としてコンマを使用して値を指定します。一度に指定できるプロパティーは 1 つだけです。インタフェースでサポートされているプロパティーおよびその指定可能な値は、show-ifprop サブコマンドで取得できます。一度に変更できるプロパティーは 1 つだけです。

-t, --temporary

この変更は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-m protocol, --module protocol

プロパティーを IPv4 パケットに適用するか IPv6 パケットに適用するかを指定します。

-p prop=value[,...], -prop prop=value[,...]

指定の値に設定するプロパティー。

reset-ifprop [-t] -m protocol -p prop interface

指定されたインタフェースのプロパティーをデフォルト値にリセットします。-t を省略すると、プロパティーの持続的な値はすべて削除されます。一度に変更できるプロパティーは 1 つだけです。

-t, --temporary

このリセットは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-m protocol, --module protocol

リセットするプロパティーを IPv4 パケットに適用するか IPv6 パケットに適用するかを指定します。

-p prop, -prop prop

指定の値に設定するプロパティー。

show-ifprop [[-c] -o field[,...]] [-p prop,...] [-m protocol] [interface]

作成されているすべてのインタフェースまたは特定のインタフェースについて、1 つまたは複数のプロパティーの現在の値と永続的な値を表示します。一度に複数のプロパティーを取得するには、プロパティー名をコンマで区切って -p オプションに指定します。- p オプションを指定しない場合、 使用可能なすべてのインタフェースプロパティーが表示されます。

-o field[,...], --output field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。field 名には、次に示すフィールドのいずれか、あるいは、すべてのフィールドを表示するための特殊な値 all を指定する必要があります。インタフェースごとに、次のフィールドを表示できます。

IFNAME

インタフェースの名前。

PROPERTY

プロパティーの名前。

PROTO

プロパティーが属しているプロトコルの名前。現在サポートされているプロトコルは IPv4 と IPv6 です。

PERM

プロパティーの読み取り権と書き込み権。表示される値は、r (読み取り専用)、w (書き込み専用)、または rw (読み書き) です。

CURRENT

プロパティーの現在の値。値が設定されていないため無効になっているインタフェースの場合は、-- と表示されます。

PERSISTENT

プロパティーの永続的な値。永続的な値は、リブート時に再度適用される値です。

DEFAULT

プロパティーのデフォルト値。プロパティーにデフォルト値がない場合は、-- と表示されます。

POSSIBLE

プロパティーに設定できる値のコンマ区切りのリスト。値に数値の範囲がある場合は、短縮形として min - max が表示される可能性があります。指定可能な値が不明な場合は ? と表示され、指定可能な値が無限の場合は -- と表示されます。

-c, --parsable

安定したマシン解析可能な形式を使用して表示します。このオプションには -o オプションが必要です。下記の「解析可能な出力形式」を参照してください。

-p prop,..., -–prop=prop

表示するプロパティーのコンマ区切りのリスト。サブコマンドの説明に続くインタフェースプロパティーのセクションを参照してください。

-m protocol, --module protocol

指定されたプロトコルに一致するプロパティーを表示します。有効な値は ipv4ipv6 です。

サポートされているインタフェースプロパティーの一覧については、後述の「インタフェースのプロパティー」を参照してください。

create-addr [-t] [-T static] [-d] -a {local | remote}=addr[/prefixlen],... addrobj | interface

インタフェースで静的 IPv4 または IPv6 アドレスを作成します。インタフェースは、明確に引数として指定するか、addrobj 引数から派生します。アドレスを作成するインタフェースがすでに存在する必要があります。作成された静的アドレスはその後 addrobj で識別されます。インタフェース引数を指定してコマンドが呼び出されると、アドレスの addrobj が自動的に生成され、生成された名前が標準出力に出力されます。


注 - 自動的に生成された addrobj 名の形式は、次のとおりです:


interface/v4            interface/v6
interface/v4a           interface/v6a
interface/v4b           interface/v6b
      .                       .
      .                       .
      .                       .
interface/v4z           interface/v6z
interface/v4aa          interface/v6aa
interface/v4ab          interface/v4ab
      .                       .
      .                       .
      .                       .

名前の自動生成では IP アドレスバージョンが使用され、1 つ以上の文字 [a-z] を v[46] 接頭辞に徐々に追加することで名前が固有になります。

デフォルトでは、構成されたアドレスは「up」とマークされるため、送信パケットと受信パケットの発信元または着信先として使用できます。

すべてのアドレスオブジェクトが作成時に有効になります。アドレスオブジェクトの無効化および有効化の手順については、disable-addr サブコマンドと enable-addr サブコマンドを参照してください。

永続的な操作を一時オブジェクトに対して実行することはできません。つまり、一時的に作成されたインタフェースには、永続的なアドレスオブジェクトを作成することはできません。

addrobj 名に指定されたインタフェースが IPMP インタフェースであれば、IPMP インタフェース上に静的データアドレスが作成されます。addrobj 名に指定されたインタフェースが IPMP グループの基になるインタフェースであれば、基になるインタフェース上に静的テストアドレスが作成されます。

-t, --temporary

構成されたアドレスは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-d, --down

構成されたアドレスを「down」とマークします。つまり、そのアドレスは IP パケットの発信元や着信先として使用されません。

-a {local | remote}=addr[/prefixlen],...
--address {local | remote}=addr[/prefixlen],...

addr は、ローカルエンドポイントまたはリモートエンドポイント (ポイントツーポイントインタフェースの場合) に対応する、リテラル IP アドレスまたはホスト名です。

ホスト名が指定されている場合は、その数値が /etc/hosts のエントリから一意に取得されます。このファイルに数値の IP アドレスが定義されていない場合は、nsswitch.conf(4)hosts または ipnodes に指定されているリゾルバの順序を使用して、数値が一意に取得されます。指定されたホスト名に複数のエントリが存在する場合は、エラーが生成されます。IP アドレスの作成はブートプロセスでネームサービスがオンラインになる前に行われるため、使用するホスト名がすべて /etc/hosts に含まれていることが重要です。

prefixlen がコマンド行で明示的に指定されていない場合、アドレスのネットマスクは次に示す順序で検索によって取得されます。

  1. nsswitch.conf(4)netmasks に指定されている順序を使用する

  2. RFC 791 で定義されているクラスフルサブネット化セマンティクスを使用して IPv4 アドレスを解釈し、RFC 4291 の定義を使用して IPv6 アドレスを解釈します。

ポイントツーポイントインタフェースの場合は、ローカルエンドポイントのアドレスとともに、リモートエンドポイントのアドレスを指定する必要があります (例: -a local=laddr,remote=raddr)。リモートエンドポイントに prefixlen を指定すると、エラーが返されます。

インタフェースにローカルアドレスだけが必要な場合は、-a オプションに直接、-a addr[/prefixlen] のように指定します。アドレスは自動的にローカルアドレスとみなされます。

create-addr [-t] -T dhcp [-w seconds | forever] [-h hostname] addrobj | interface

インタフェースで DHCP によって制御される IPv4 アドレスを作成します。インタフェースは、明確に引数として指定するか、addrobj 引数から派生します。作成された IPv4 アドレスはその後 addrobj で識別されます。このコマンドの addrobj に、基になるインタフェースを指定するとテストアドレスが作成され、IPMP インタフェースを指定するとデータアドレスが作成されます。

インタフェース引数を指定してコマンドが呼び出されると、アドレスの addrobj 名が自動的に生成され、生成された名前が標準出力に出力されます。

すべてのアドレスオブジェクトが作成時に有効になります。アドレスオブジェクトの無効化および有効化の手順については、disable-addr サブコマンドと enable-addr サブコマンドを参照してください。

永続的な操作を一時オブジェクトに対して実行することはできません。つまり、一時的に作成されたインタフェースには、永続的なアドレスオブジェクトを作成することはできません。

addrobj 名に指定されたインタフェースが IPMP インタフェースであれば、DHCP によって取得されたアドレスが IPMP インタフェース上にデータアドレスとして作成されます。

-h hostname

クライアントが DHCP サーバーでクライアントのリース済み IPv4 アドレスをマップさせるホスト名を指定します。DHCP サーバーがホスト名の要求を満たせるという保証はありません。

-t, --temporary

構成されたアドレスは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-w seconds | forever, --wait seconds | forever

処理が完了するまで待つ時間を秒単位で指定します。待機時間が指定されず、かつ処理内容がすぐに完了できない性質のものであった場合、ipadm はデフォルトで 120 秒間、要求された処理が完了するのを待ちます。デフォルトの待機時間は将来のリリースで変更される可能性があります。シンボリック値 forever も、リテラルな意味で使用できます。

create-addr [-t] -T addrconf [-i {local | remote}=interface-id] [-p {stateful | stateless}={yes | no},..] addrobj | interface

インタフェースで自動構成された IPv6 アドレスを作成します。インタフェースは、明確に引数として指定するか、addrobj 引数から派生します。作成された IPv6 アドレスは addrobj で識別されます。インタフェース引数を指定してコマンドが呼び出されると、アドレスの addrobj 名が自動的に生成され、生成された名前が標準出力に出力されます。

自動構成アドレスは、デフォルトのインタフェース ID を使用して生成されます (メディアタイプが Ethernet の場合、インタフェース ID はインタフェースの MAC アドレス)。この動作は -i オプションで上書きできます。

デフォルトでは、次のようになります。

  • RFC 4862 に記述されているとおり、IPv6 アドレスは、ルーターで通知される接頭辞に基づいて自動構成されます。さらに、

  • RFC 3315 に記述されているとおり、IPv6 アドレスは、DHCPv6 サーバーから提供される IPv6 アドレスを使用して、指定のインタフェース上に自動構成されます。(つまり、デフォルトのオプションは -p stateful=yes,stateless=yes です。)

すべてのアドレスオブジェクトが作成時に有効になります。アドレスオブジェクトの無効化および有効化の手順については、disable-addr サブコマンドと enable-addr サブコマンドを参照してください。

永続的な操作を一時オブジェクトに対して実行することはできません。つまり、一時的に作成されたインタフェースには、永続的なアドレスオブジェクトを作成することはできません。

addrobj 名に指定されたインタフェースが IPMP インタフェースであれば、IPv6 自動設定によって取得されたアドレスが IPMP インタフェース上にデータアドレスとして作成されます。

-t, --temporary

構成されたアドレスは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-i {local | remote}=interface-id, --interface-id {local | remote}=interface-id

自動構成アドレスの生成に使用するインタフェース ID を指定します。

ポイントツーポイントインタフェースの場合は、リモートエンドポイントのインタフェース ID を指定できます (例: -i local=lid,remote=rid)。

インタフェースにローカルインタフェース ID だけが必要な場合は、-i オプションに直接、-i lid のように指定します。インタフェース ID は自動的にローカルインタフェース ID とみなされます。

-p {stateful | stateless}={yes | no},..
--prop {stateful | stateless}={yes | no},..

ステートフル自動設定方法とステートレス自動設定方法の一方または両方を有効にするかどうかを指定します。

-p stateful=no を指定すると、DHCPv6 で指定される IPv6 アドレスに基づいたステートフル自動設定は実行されません。

-p stateless=no を指定すると、ルーターで通知される接頭辞に基づいたステートレス自動設定は実行されません。

-p stateful=no,stateless=no を指定すると、どちらの方法の自動設定も実行されません。

-T addrconf オプションでは、デフォルトで -p stateful=yes,stateless=yes が使用されます。

delete-addr [-r] addrobj

addrobj で指定されたインタフェース上の、addrobj で識別されるアドレスをすべて削除します。これらのアドレスは永続的データストアからも削除されるため、リブート時にこれらのアドレスはインスタンス化されません。

アドレスオブジェクトが DHCP によって制御されるアドレスの場合、delete-addr は DHCP サーバーに通知することなくシステムからこのアドレスを削除し、あとで使用できるように現在のリースを記録します。

-r, --release

addrobj が DHCP によって制御されるアドレスの場合、このオプションを指定すると、インタフェース上の DHCP によって制御される IP アドレスがサーバーへの通知によって解放され、現在のリースが破棄されます。

show-addr [[-p] -o field[,...]] [-d] [addrobj | interface/]

指定された addrobj について、または指定されたインタフェース上に構成されているすべてのアドレスオブジェクト (永続的な構成だけに存在するアドレスオブジェクトも含む) について、アドレス情報を表示します。

-p, --parsable

安定したマシン解析可能な形式を使用して表示します。このオプションには -o オプションが必要です。下記の「解析可能な出力形式」を参照してください。

-o field[,...], --output field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。field 名には、次に示すフィールドのいずれか、あるいは、すべてのフィールドを表示するための特殊な値 all を指定する必要があります。インタフェースごとに、次のフィールドを表示できます。

ADDROBJ

アドレスオブジェクトの名前。

TYPE

アドレスオブジェクトのタイプ。from-gzstaticdhcp、または addrconf のいずれかです。staticdhcp、および addrconf タイプは、create-addr-T オプションで指定されたアドレスオブジェクトのタイプに対応します。from-gz タイプは、非大域ゾーンでのみ表示され、非大域排他的 IP ゾーンに設定されている allowed-address プロパティーに基づいて大域ゾーンから構成されたアドレスであることを示します。

STATE

アドレスオブジェクトの状態。このフィールドは、-oall を指定した場合だけ表示されます。次のいずれかの値が表示されます。

disabled

アドレスはアクティブな構成に含まれています (disable-addrdisable-if を参照)。

down

アドレスは管理上停止されています (down-addr を参照)。

duplicate

アドレスは、別のシステムの IP アドレスと競合していることが重複アドレス検出 (DAD) で見つかったため、競合が解決されるまで使用できません。システムでは、競合が解決されたかどうかを調べるために、定期的に DAD が実行されます。または、refresh-addr を使用して DAD をただちに再実行することもできます。

inaccessible

アドレスが構成されている IP インタフェースに障害が発生したため、アドレスは使用できません。

ok

アドレスは有効で、稼働しており、正しく動作しています。システムは、このアドレス宛の IP パケットを受け入れます。また、構成されている IP 発信元アドレス選択ポリシーに従い、このアドレスを使用して IP パケットを発信します。

tentative

現在、アドレスには重複アドレス検出が行われています (たとえば、up-addr または refresh-addr の一環として)。

CURRENT

アクティブな構成のアドレスオブジェクトに関して、次のフラグのいずれかを示します。このフィールドはデフォルトでは表示されず、-oall または current を指定した場合のみ表示されます。

d (deprecated)

このアドレスが送信パケットの発信元アドレスとして使用されるのは、そのインタフェース上で利用可能なアドレスがほかに存在しない場合と、アプリケーションがこのアドレスに明示的にバインドした場合だけです。

p (private)

このアドレスはルーティングデーモンによって通知されません。

t (temporary)

RFC 3041 で定義されている一時 IPv6 アドレスです。

U (up)

アドレスは「up」とマークされ、送信/受信パケットの発信元/着信先として使用できます。

u (unnumbered)

アドレスは、システム内のほかのリンクのローカルアドレスに一致しています。

PERSISTENT

アドレスオブジェクトがリブート時にインスタンス化されるとき、または enable-addr サブコマンドで再度有効化されるときに適用する構成を指定します。有効な値は、Up、および d の任意の組み合わせです (前述の説明を参照)。

ADDR

数値の IPv4 または IPv6 アドレス。ポイントツーポイントインタフェースの場合は、両方のエンドポイントのアドレスが表示されます (laddr-->raddr)。dhcp タイプのアドレスオブジェクトの場合は、アドレスオブジェクトの状態が disabled であるか、アドレスが IPv4 アドレス 0.0.0.0 または IPv6 アドレス :: であれば、疑問符 (?) が表示されます。

CID-TYPE

アドレスが DHCP を使用して取得されている場合は、dhcpagent(1M) で使用されるクライアント ID のタイプ。IPv4 の場合は、RFC 4361 のクライアント ID の構築に使用される DUID のタイプが表示されます。タイプは DUID-LLTDUID-ENDUID-LLother、または default のいずれかです。このフィールドはデフォルトの出力には表示されません。表示するには、-d を使用するか、-ocid-type または all を使用します。

DUID-LLT

タイプ 1 の RFC 3315 DUID が CID-VALUE の構築に使用されます (例: 1,1,63463777,0a:0b:0c:0d:0e:0f)。詳細については、RFC を参照してください。

DUID-EN

タイプ 2 の RFC 3315 DUID が CID-VALUE の構築に使用されます (例: 1,1,63463777,0a:0b:0c:0d:0e:0f)。詳細については、RFC を参照してください。

DUID-LL

タイプ 3 の RFC 3315 DUID が CID-VALUE の構築に使用されます (例: 1,1,63463777,0a:0b:0c:0d:0e:0f)。詳細については、RFC を参照してください。

other

タイプ {0,4-65535} の RFC 3315 DUID がクライアント ID の生成に使用されます (例: 4,0x734633)。または、CID-VALUE は、RFC 3315 に準拠していないクライアント ID そのものです (例: Sun0xab3146)。

default

クライアント ID の構築に RFC 3315 DUID は使用されていないことを示します。代わりに、RFC 2132 に従い、インタフェースの MAC アドレスを使用してクライアント ID が生成されます。CID-VALUE は、文字列 0x01 とそれに続く MAC アドレスの 16 進文字列で構成されます。これは IPv4 の場合にのみ当てはまります。

CID-VALUE

アドレスが DHCP を使用して取得されている場合は、dhcpagent(1M) で使用されるクライアント ID の値。使用される形式は、/etc/default/dhcpagent ファイル内の構成パラメータ CLIENT_ID の形式に従います。dhcpagent(1M)CLIENT_ID の説明を参照してください。CID-TYPE が default の場合、CID-VALUE は、RFC 2132 に従って構築されたレガシー CLIENT-ID になります。このフィールドはデフォルトの出力には表示されません。表示するには、-d を使用するか、-ocid-type または all を使用します。

BEGIN

DHCP を使用して取得されたアドレスの場合、リースが開始された時間 (存在する場合)。時間は、LC_TIME ロケール環境変数で規定される形式で表示されます。DHCP によって構成されないアドレス、あるいは、まだリースが取得されていない DHCP アドレスの場合は、-- (2 つのハイフン) が表示されます。このフィールドはデフォルトの出力には表示されません。表示するには、-d を使用するか、-ocid-type または all を使用します。

EXPIRE

DHCP を使用して取得されたアドレスの場合、リースが期限切れになる時間 (存在する場合)。時間は、LC_TIME ロケール環境変数で規定される形式で表示されます。DHCP によって構成されないアドレス、あるいは、まだリースが取得されていない DHCP アドレスの場合は、-- (2 つのハイフン) が表示されます。このフィールドはデフォルトの出力には表示されません。表示するには、-d を使用するか、-ocid-type または all を使用します。

RENEW

DHCP を使用して取得されたアドレスの場合、リースが最後に更新された時間。時間は、LC_TIME ロケール環境変数で規定される形式で表示されます。DHCP によって構成されないアドレス、あるいは、まだリースが取得されていない DHCP アドレスの場合は、-- (2 つのハイフン) が表示されます。このフィールドはデフォルトの出力には表示されません。表示するには、-d を使用するか、-ocid-type または all を使用します。

-d, --dhcp

DHCP を使用して取得されたアドレスの dhcp ステータスフィールドを表示します。表示されるフィールドは、ADDROBJSTATEADDRCID-TYPECID-VALUEBEGINEXPIRE 、および RENEW です。このオプションの出力は人間が読める形式だけです。このオプションを -p と組み合わせて使用することはできません。


注 - 場合によっては、アドレスオブジェクト名に疑問符 (?) が付いたアドレスが表示されることがあります。これは、そのアドレスが ipadm ライブラリの外部で作成されたものであり、ipadm には認識されていないことを意味します。


down-addr [-t] addrobj

addrobj で識別されるアドレスを「down」とマークして、送信/受信パケットの発信元/着信先として使用できないようにします。このコマンドは、down-addr の呼び出しの前にすでに「down」とマークされていたアドレスオブジェクトには影響しません。アドレスオブジェクトが addrconf タイプの場合、このコマンドはエラーを返します。

-t, --temporary

構成されたアドレスは一時的なもので、変更はアクティブな構成だけに適用されることを示します。アドレスオブジェクトのタイプが dhcp の場合、このオプションは必須です。

up-addr [-t] addrobj

addrobj で識別されるアドレスを「up」とマークして、送信/受信パケットの発信元/着信先として使用できるようにします。このサブコマンドは、重複アドレスなのでシステムによって「down」とマークされているアドレスオブジェクトや、up-addr の呼び出しの前にすでに「up」とマークされていたアドレスオブジェクトには影響しません。アドレスオブジェクトが addrconf タイプの場合、このコマンドはエラーを返します。

-t, --temporary

構成されたアドレスは一時的なもので、変更はアクティブな構成だけに適用されることを示します。アドレスオブジェクトのタイプが dhcp の場合、このオプションは必須です。

refresh-addr [-i] addrobj

addrobjstatic タイプの場合、このアドレスオブジェクトで識別されるアドレスに対し、必要に応じて DAD (重複アドレス検出) が再開されます。

addrobjdhcp タイプの場合、このアドレスに取得されたリース期間が DHCP クライアントデーモンによって延長されます。

addrobjaddrconf タイプの場合、このコマンドはエラーを返します。

-i, --inform

指定された IP アドレスについて、DHCP からネットワーク構成パラメータを取得します。その際、アドレスのリースは取得しません。これは、DHCP 以外のメカニズムを使って IP アドレスを取得する場合に役立ちます。

disable-addr -t addrobj

アドレスをアクティブな構成から削除することによって無効にします。もともと永続的なアドレスオブジェクトとして作成されていた場合、永続的な構成は変更されません。この addrobj を再度有効にするには、enable-addr を使用するようにしてください。

-t, --temporary

この無効化は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

enable-addr -t addrobj

構成を永続的ストアから読み取ることで、指定された addrobj を有効にします。アドレスオブジェクトには、永続的なアドレスプロパティーがすべて適用されます。このサブコマンドでは、アドレスオブジェクトを有効にするインタフェースが存在する必要があります。インタフェース自体がアクティブな構成には存在せず永続的ストアには存在する場合、つまりインタフェースが無効になっている場合は、enable-addr を呼び出す前に enable-if を実行する必要があります。

-t, --temporary

この有効化は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

set-addrprop [-t] -p prop=value[,...] addrobj

指定された addrobj にプロパティーの値を設定します。addrobj が複数のアドレスに対応している場合は、addrobj で参照されるすべてのアドレスにプロパティーの変更が適用されます。一度に指定できるプロパティーは 1 つだけです。addrobj でサポートされているプロパティーおよびその指定可能な値は、show-addrprop サブコマンドで取得できます。addrobjaddrconf タイプの場合、このコマンドはエラーを返します。

-t, --temporary

この変更は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-p prop=value[,...], -–prop prop=value[,...]

指定の値に設定するプロパティー。

reset-addrprop [-t] -p prop addrobj

指定されたアドレスのプロパティーをデフォルト値にリセットします。-t を省略すると、プロパティーの永続的な値はすべて削除されます。一度に変更できるプロパティーは 1 つだけです。addrobjaddrconf タイプの場合、このコマンドはエラーを返します。

-t, --temporary

このリセットは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-p prop, -–prop prop

リセットするプロパティー。

show-addrprop [[-c] -o field[,...]] [-p prop,...] [addrobj]

構成されているすべてのアドレスオブジェクトまたは特定の addrobj について、1 つまたは複数のプロパティーの現在の値と永続的な値を表示します。一度に複数のプロパティーを取得するには、プロパティー名をコンマで区切って -p オプションに指定します。-p オプションを指定しない場合、 使用可能なすべてのプロパティーが表示されます。addrobjaddrconf タイプの場合、このコマンドはエラーを返します。

-o field[,...], --output field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。field 名には、次に示すフィールドのいずれか、あるいは、すべてのフィールドを表示するための特殊な値 all を指定する必要があります。addrobj ごとに、次のフィールドを表示できます。

ADDROBJ

アドレスオブジェクトの名前。

PROPERTY

プロパティーの名前。

PERM

プロパティーの読み取り権と書き込み権。表示される値は、r (読み取り専用)、w (書き込み専用)、または rw (読み取り/書き込み) です。

CURRENT

プロパティーの現在の値。値が設定されていないため無効になっているアドレスの場合は、2 つのハイフン (--) が表示されます。

PERSISTENT

プロパティーの永続的な値。永続的な値は、リブート時に再度適用される値です。

DEFAULT

プロパティーのデフォルト値。プロパティーにデフォルト値がない場合は、2 つのハイフン (--) が表示されます。

POSSIBLE

プロパティーに設定できる値のコンマ区切りのリスト。値に数値の範囲がある場合は、短縮形として min - max が表示される可能性があります。指定可能な値が不明な場合は疑問符 (?) が表示され、指定可能な値が無限の場合は 2 つのハイフン (--) が表示されます。

-c, --parsable

安定したマシン解析可能な形式を使用して表示します。このオプションには -o オプションが必要です。下記の「解析可能な出力形式」を参照してください。

-p prop,..., -–prop=prop

表示するプロパティーのコンマ区切りのリスト。サブコマンドの説明に続くアドレスオブジェクトのプロパティーに関するセクションを参照してください。

set-prop [-t] -p prop[+ | –]=value[,...] protocol

プロトコルのプロパティーの値を、指定された value に変更します。プロパティーが複数の値を取る場合は、区切り文字としてコンマを使用して値を指定します。一度に指定できるプロパティーは 1 つだけです。デフォルトでは、値は永続的で、リブート時に再度適用されます。プロトコルでサポートされているプロパティーおよびその指定可能な値は、show-prop サブコマンドで取得できます。

サポートされているプロトコルは、ipipv4ipv6icmptcpudp、および sctp です。

一部のプロパティーでは、プロパティーの値をグローバルに設定することもインタフェースごとに設定することもできます。インタフェースごとの値は set-ifprop サブコマンドで設定できます。そのような場合、管理者がプロパティーのインタフェースごとの値をカスタマイズして、グローバルな値とは異なる値にすると、そのインタフェースではグローバルな設定よりもインタフェースごとの値が優先されます。

-t, --temporary

このプロパティーの変更は一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-p prop[+|-]=value[,...], -–prop prop[+|-]=value[,...]

指定の値に設定するプロパティー。次の「修飾子」も提供されているため、割り当て操作に加え、追加操作と削除操作も実行できます。

+

指定された値を現在の値リストに追加します。

-

指定された値を現在の値リストから削除します。

=

新しい割り当てを行い、現在の値はすべて削除します。

修飾子の使用方法の詳細については、「使用例」を参照してください。

reset-prop [-t] -p prop protocol

指定されたプロトコルのプロパティーを、そのプロパティーのデフォルト値にリセットします。-t を使用しない場合、プロパティーの永続的な値はすべて削除されます。一度に変更できるプロパティーは 1 つだけです。

-t, --temporary

このリセットは一時的なもので、変更はアクティブな構成だけに適用されることを示します。

-p prop, -–prop prop

リセットするプロパティー。

show-prop [[-c] -o field[,...]] [-p prop[,...] protocol | protocol]

サポートされているすべてのプロトコルまたは特定のプロトコルについて、1 つまたは複数のプロパティーの現在の値と永続的な値を表示します。一度に複数のプロパティーを取得するには、プロパティー名をコンマで区切って -p オプションに指定します。-p オプションを指定しない場合、 使用可能なすべてのプロパティーが表示されます。

-o field[,...], --output field[,...]

表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。field 名には、次に示すフィールドのいずれか、あるいは、すべてのフィールドを表示するための特殊な値 all を指定する必要があります。各 protocol について、次のフィールドを表示できます。

PROTO

プロトコルの名前。

PROPERTY

プロパティーの名前。

PERM

プロパティーの読み取り権と書き込み権。表示される値は、r (読み取り専用)、w (書き込み専用)、または rw (読み取り/書き込み) です。

CURRENT

プロパティーの現在の値。値が設定されていないため無効になっているアドレスの場合は、2 つのハイフン (--) が表示されます。値が不明な場合は疑問符 (?) が表示されます。プロパティーの現在の値が POSSIBLE 値のリストに含まれていない場合は、キーワード custom が表示されます。

PERSISTENT

プロパティーの永続的な値。永続的な値は、リブート時に再度適用される値です。

DEFAULT

プロパティーのデフォルト値。プロパティーにデフォルト値がない場合は、2 つのハイフン (--) が表示されます。

POSSIBLE

set-prop サブコマンドで使用するプロパティー設定の値のコンマ区切りのリスト。値に数値の範囲がある場合は、短縮形として min - max が表示される可能性があります。指定可能な値が不明な場合は疑問符 (?) が表示され、指定可能な値が無限の場合は 2 つのハイフン (--) が表示されます。

-c, --parsable

安定したマシン解析可能な形式を使用して表示します。このオプションには -o オプションが必要です。下記の「解析可能な出力形式」を参照してください。

-p prop,..., -–prop=prop

表示するプロパティーのコンマ区切りのリスト。サブコマンドの説明に続くプロトコルのプロパティーに関するセクションを参照してください。

各プロトコルでサポートされているプロパティーの一覧については、後述の「プロトコルのプロパティー」を参照してください。

help [subcommand-name]

サポートされるすべての ipadm サブコマンドまたは特定のサブコマンドの使用法を表示します。特定のサブコマンドのヘルプを表示すると、コマンド構文および例が表示されます。引数なしで ipadm help を使用すると、すべてのサブコマンドが表示されます。

解析可能な出力形式

ipadm の一連の「show」サブコマンドには、マシン解析可能な形式で出力を表示する -o オプションがあります。この出力形式は、コロン (:) で区切られたフィールドで構成された 1 つ以上の行です。表示されるフィールドは、使用されているサブコマンドに固有のもので、特定のサブコマンドの -o オプションに対するエントリの下に一覧表示されます。出力には、-o オプションを使用して要求されたフィールドのみが、要求された順序で表示されます。サブコマンドのすべてのフィールドを表示する -o all オプションは、解析可能な出力には使用できません。

複数のフィールドを要求した場合、すべてのコロン文字は、バックスラッシュ (\) でエスケープされてから出力されます。同様に、バックスラッシュ文字もエスケープされます (\\)。このエスケープ形式は、環境変数 IFS=: を設定したシェルの read(1) 関数を使って解析できます。ただし、1 つのフィールドだけを要求した場合はエスケープは行われません。

プロトコルのプロパティー

次のプロトコルプロパティーがサポートされています。


注 - プロトコルに固有の、「_」(下線) で始まるプロトコルプロパティーがあります。これらのプロパティーはデフォルトで変更または削除されることがあり、ipadm show-prop 出力には表示されません。詳細は、『Oracle Solaris Tunable Parameters Reference Manual』を参照してください。


cong_default (TCP, SCTP)

新しい接続の作成時にプロトコルによって使用されるデフォルトの輻輳制御アルゴリズムを指定します。あとで接続の有効期間内にアプリケーションで別のアルゴリズムを選択することもできます。デフォルトとして設定できるのは有効になっているアルゴリズムのみです (cong_enabled を参照)。

cong_enabled (TCP, SCTP)

このオプションを使用すると、輻輳制御アルゴリズムを有効または無効にすることができます。デフォルトでは、システムにインストールされているすべてのアルゴリズムが有効になります。無効になっているアルゴリズムをデフォルトとして設定したり (cong_default を参照)、アプリケーションで使用したりすることはできません。

アルゴリズムの追加または削除には、set-prop サブコマンドと修飾子 + および - を使用します。

ecn (TCP)

明示的な輻輳制御 (詳細は、RFC 3168 を参照)。指定可能な値は、上記と同じ neverpassive、および active です。

extra_priv_ports (TCP, SCTP, UDP)

このオプションは、1-1023 の範囲外にある追加の特権ポートを定義します。このリストに含まれるポートにバインドしようとするプログラムは、root ユーザーとして実行する必要があります。これにより、通常ユーザーが特定のポートでサーバープロセスを開始することを防止します。

これらのポートの追加、削除、および割り当てを行うには、set-prop サブコマンドと修飾子 +-、および = を使用します。使用方法については、後述の「使用例」を参照してください。

forwarding (IPv4), forwarding (IPv6)

グローバルな IPv4 転送または IPv6 転送を有効または無効にします。構成されているすべてのインタフェースがパケットの転送を開始または停止します。set-ifprop による個々のインタフェースの設定は、このグローバルなオプションよりも優先されます。

hostmodel (IPv4), hostmodel (IPv6)

マルチホームシステムでの IP パケットの送受信動作を制御します。hostmodel の値は strong または weak に設定できます。これは、RFC 1122 の同等のエンドシステムモデル定義に対応します。さらに、3 つ目の値 src-priority もサポートされています。src-priority hostmodel シナリオでは、パケットの着信先 IP アドレスがホストのいずれかのインタフェース上に構成され「UP」とマークされていれば、パケットは任意のインタフェースで受け入れられます。パケットの送信時、パケットの IP 着信先への経路が複数ある場合は、パケットの IP 発信元アドレスが送信インタフェース上に構成されている経路が優先されます。そのような経路がない場合、弱い ES の場合と同様に、フォールバックによって「最適な」経路が選択されます。

max_buf (TCP, SCTP, UDP, ICMP)

ソケットの送信バッファーまたは受信バッファーの最大サイズ。このプロパティーの現在の値によって、recv_bufsend_buf の最大値が制限されます。

recv_buf (TCP, SCTP, UDP, ICMP)
send_buf (TCP, SCTP, UDP, ICMP)

指定されたプロトコルの受信バッファーサイズまたは送信バッファーサイズを変更します。これらのプロパティーの最大値は、max_buf プロパティーの現在の値に制約されます。

sack (TCP)

選択的肯定応答 (SACK) を使用すると、受信者は順序の誤ったデータを選択的に受け入れることができます。損失の多いリンクでデータ転送のパフォーマンスを向上させるためのものです。SACK については、RFC 2018 を参照してください。指定可能な値とその意味は次のとおりです。

never

SACK を受け入れず、SACK 情報の送信も行いません。

passive

SACK を受け入れますが、送信はしません。

active

SACK を受け入れ、SACK 情報の送信も行います。

smallest_anon_port (TCP, SCTP, UDP)
largest_anon_port (TCP, SCTP, UDP)

これらのオプションは、エフェメラルポートの上限と下限を定義します。エフェメラル (「短命な」の意) ポートは、発信ネットワーク接続を確立するときに使用されます。smallest_anon_port の現在の値は、常に largest_anon_port の現在の値以下になるようにしてください。

smallest_nonpriv_port (TCP, SCTP, UDP)

このオプションは、非特権ポートの開始を定義します。通常、非特権ポートの範囲は 1024 から始まります。非特権ポートにバインドしようとするプログラムは、root ユーザーとして実行する必要はありません。

ttl (IPv4), hoplimit (IPv6)

IPv4 ヘッダーまたは IPv6 ヘッダーの ttl/hoplimit フィールドに設定する値を指定します。システムが N ホップより遠くにあるほかのシステムに到達することを防止するために使用できます。この N は、指定した値です。

インタフェースのプロパティー

次のインタフェースプロパティーがサポートされています。

arp

インタフェースでのアドレス解決プロトコル (ARP) の使用を有効または無効にします。ARP は、ネットワークレベルのアドレスとリンクレベルのアドレスとの間のマッピングに使用されます。これは現時点では、IPv4 アドレスと MAC アドレス間のマッピング用として実装されています。指定可能な値は、on または off です。デフォルトは on です。

exchange_routes

このインタフェースでの経路指定情報の交換を有効または無効にします。指定可能な値は、on または off です。デフォルトは off です。

group

このインタフェースが基になるインタフェースとして属している IPMP インタフェースのグループ名を指定します。インタフェースのクラスが IPMP の場合、これは IPMP グループの名前を指定します。このプロパティーは IPMP インタフェースでのみ読み書き可能です。ほかのインタフェースクラスの場合、このプロパティーは読み取り専用です。

forwarding

インタフェースでの IP 転送を有効または無効にします。有効になっている場合、このインタフェースへの、およびこのインタフェースからの、IP パケットの転送を行えます。指定可能な値は、on または off です。デフォルトは off です。

metric

インタフェースの経路指定メトリックを n に設定します。値が指定されなかった場合のデフォルトは、0 になります。経路指定メトリックは、経路指定プロトコルによって使用されます。メトリックが高いほど、その経路は好まれません。メトリックは、着信先となるネットワークまたはホストへの加算ホップとしてカウントされます。

mtu

インタフェースの最大転送単位を n に設定します。多くのネットワークタイプでは、MTU には上限があります。たとえば、Ethernet の場合は 1500 です。

nud

特定のポイントツーポイント物理インタフェース上で近傍不到達検出メカニズムを有効または無効にします。指定可能な値は、on または off です。デフォルトは on です。

standby

このインタフェースを IPMP グループの予備インタフェースとして構成するかどうかを指定します。このプロパティーは IPMP インタフェースには適用できません。

usesrc

特定の物理インタフェースまたは仮想インタフェースを発信元アドレス選択用として指定します。キーワード none を使用した場合、それまでの選択がすべてクリアされます。デフォルトは none です。

アドレスのプロパティー

次のアドレスプロパティーがサポートされています。addrconf アドレスオブジェクトのアドレスプロパティーの変更はサポートされていません。

deprecated

新しい通信ではこのアドレスを発信元アドレスとして使用しないようにしてください。ただし、このアドレス宛のパケットは期待どおりに処理されます。指定可能な値は、on または off です。デフォルトは off です。このプロパティーは dhcp タイプのアドレスオブジェクトではサポートされていません。

prefixlen

アドレスの左から何ビットがアドレスの IPv6 接頭辞または IPv4 ネットマスクに該当するかを指定します。残りの下位ビットは、アドレスのホスト部を定義します。prefixlen をアドレスのテキスト表現に変換すると、アドレスのネットワーク部として使用するビット位置には 1 が、ホスト部として使用するビット位置には 0 が含まれています。prefixlen は単一の 10 進数で指定する必要があります。このプロパティーは dhcp タイプのアドレスオブジェクトではサポートされていません。

private

アドレスを in.routed ルーティングデーモンで通知しないように指定します。指定可能な値は、on または off です。デフォルトは off です。

reqhost

クライアントが DHCP サーバーでクライアントのリース済み IPv4 をマップさせるホスト名。ホスト名の要求が満たされる保証はありません。

transmit

アドレスオブジェクトで参照されるアドレスを使用してパケットを送信できるようにします。これは、アドレスが「up」状態にある場合のデフォルト動作です。指定可能な値は、on または off です。デフォルトは on です。

zone

アドレスオブジェクトで参照されるすべてのアドレスを配置するゾーンを指定します。指定されたゾーンは、カーネル内でアクティブになっており、準備完了か実行中の状態になっていなければいけません。ゾーンが停止またはリブートすると、インタフェースは unplumb されます。ゾーンは共有 IP ゾーンとして構成されている必要があります。排他的 IP ゾーンにネットワークインタフェース名を割り当てるには、zonecfg(1M) を使用します。ゾーンの割り当てがリブート後も持続するように変更するには、zonecfg(1M) を使用してください。指定可能な値は、システム上に構成されているすべてのゾーンのリストです。デフォルトは global です。

オペランド

ipadm サブコマンドは、次のいずれかのオブジェクトに対して動作します。

addrobj

ネットワークインタフェース上に構成されているアドレスは addrobj で識別されます。addrobj は 2 つの部分から成ります。最初の部分は、アドレスが構成されているネットワークインタフェースの名前です。2 つ目の部分は、ユーザーが指定した文字列です。任意の英数字を 32 文字まで使用でき、英文字で始まる必要があります。addrobj の 2 つの部分はスラッシュ (/) で区切られます。アドレスオブジェクトは常に、システム内にあるアドレスの一意のセットを表します。


注 - この名前空間ルールの例外としては、ipadm の外部で作成される一部のアドレスは、addrobj の 2 番目の部分に接頭辞が含まれている addrobj で作成されることがあります。そのような場合、addrobj の 2 番目の部分には、接頭辞「.」(ピリオド) 区切り記号とコンシューマ定義の文字列 (たとえば、net0/zoneadmd.v4) が含められます。ipadm はピリオドが含まれる addrobj を作成できないため、ipadm ユーザーはこの形式で addrobj を作成できません。最良ではありませんが、ipadm を使用して、このタイプの addrobj をさらに管理できます。


interface

ネットワークアドレスが構成されているネットワークインタフェースの名前。一般に、この名前には任意の英数字に加えて下線 (_) とピリオド (.) も使用できますが、英字で始まり、数字で終わる必要があります。

protocol

プロパティーを構成する TCP/IP インターネットプロトコルファミリの名前。サポートされているプロトコルは、ipipv4ipv6icmptcpsctp、および udp です。

使用例

例 1 引数なしで ipadm を使用する

次のコマンドは、システムでのインタフェースおよびアドレス構成の簡単なビューを表示します。

# ipadm
NAME             CLASS/TYPE STATE     UNDER   ADDR
ipmp0            ipmp       degraded  --      --
  ipmp0/v6       static     ok        --      2001:db8:1:2::4c08/128
lo0              loopback   ok        --      --
  lo0/v4         static     ok        --      127.0.0.1/8
  lo0/v6         static     ok        --      ::1/128
net0             ip         ok        --      --
  net0/dhcp      dhcp       ok        --      10.132.146.234/23
  net0/v4        static     ok        --      10.132.146.233/23
net1             ip         failed    ipmp0   --
  net1/aconf     addrconf   ok        --      fe80::214:4fff:fe58:1831/10
net2             ip         ok        ipmp0   --
  net2/aconf     addrconf   ok        --      fe80::214:4fff:fe58:1832/10

例 2 IPv4 静的アドレスの作成

次のコマンドは、インタフェース bge1 (リンク名 net1) 上にアドレス 10.2.3.4/24 を作成し、そのアドレスを使用するために「up」とマークします。

# ipadm create-ip net1
# ipadm create-addr -T static -a local=10.2.3.4/24 net1/v4static1

または、アドレスオブジェクト名の自動生成を使用できます。自動的に生成される名前はコンソールに表示され、アドレスオブジェクト名を必要とする将来の ipadm コマンドで使用できます。

# ipadm create-ip net1
# ipadm create-addr -T static -a local=10.2.3.4/24 net1
net1/v4

次のコマンドは、インタフェース net1 上に別のアドレス 10.2.3.5/24 を作成しますが、明示的に「up」とマークされるまでアドレスを「down」とマークします。

# ipadm create-addr -T static -d -a 10.2.3.5/24 net1
net1/v4

local が使用されておらず、指定されたアドレスが 1 つだけなので、10.2.3.5/24 はローカルアドレスとみなされます。

次のコマンドは、以前に「down」とマークされたアドレスオブジェクト net1/v4a を「up」とマークします。

# ipadm up-addr net1/v4a

アドレスオブジェクトに DUPLICATE フラグが設定されていた場合は、アドレスがネットワーク上でまだ重複しているかどうかを refresh-addr で確認します。そうでない場合、アドレスは「up」とマークされます。

# ipadm refresh-addr net1/v4a

次のコマンドは、構成されているアドレスを一覧表示します。これは、アドレス net1/v4a が重複していないことを示します。

# ipadm show-addr
ADDROBJ          TYPE    STATE      ADDR
lo0/v4           static  ok         127.0.0.1/8
lo0/v6           static  ok         ::/128
net1/v4          static  ok         10.2.3.4/24
net1/v4a         static  ok         10.2.3.10/24

例 3 DHCPv4 によって制御されるアドレスの作成

次のコマンドは、インタフェース bge1 (リンク名 net1) 上の DHCPv4 アドレスを取得します。

# ipadm create-ip net1
# ipadm create-addr -T dhcp net1/dhaddr
# ipadm show-addr net1/dhaddr
ADDROBJ          TYPE    STATE      ADDR
net1/dhaddr      dhcp    ok         10.8.48.173/25

次のコマンドは、DHCPv4 アドレスオブジェクト net1/dhaddr のリース期間を延長します。

# ipadm refresh-addr net1/dhaddr

例 4 IPv6 アドレスの作成

次の一連のコマンドは、in.ndpd をデフォルトのインタフェース ID とともに使用して、IPv6 アドレスを bge1 (リンク名 net1) 上に自動構成します。リンクローカルアドレスが最初に構成されたあと、ステートレスおよびステートフルな自動構成アドレスが in.ndpd によって追加されます。

# ipadm create-ip net1
# ipadm create-addr -T addrconf net1/v6addr

次のコマンドは、IPv6 静的アドレスを作成します。リンクローカルアドレスでない IPv6 アドレスを構成するには、インタフェース上にリンクローカルアドレスがすでに構成されている必要があります。これは、前の手順の -T addrconf で達成されています。

# ipadm create-addr -T static -a local=2ff0::f3ad/64 net1/v6static

次のコマンドは、IPv6 アドレスの接頭辞の長さを変更します。

# ipadm set-addrprop -p prefixlen=80 net1/v6static

すべての自動構成アドレスおよび更新された接頭辞の長さは、アドレスを一覧表示することで確認できます。

# ipadm show-addr
ADDROBJ       TYPE     STATE     ADDR
lo0/v4        static   ok        127.0.0.1/8
lo0/v6        static   ok        ::/128
net1/v6addr   addrconf ok        fe80::203:baff:fe94:2f01/10
net1/v6addr   addrconf ok        2002:a08:39f0:1:203:baff:\
                                            fe94:2f00/64
net1/v6addr   addrconf ok        2001:db8:1:2::402f/128
net1/v6static static   ok        2ff0::f3ad/80

例 5 IPv4 トンネルの構成

次に示す最初のコマンド (ipadm) は、トンネルの発信元アドレスを作成します。次に、dladm コマンドでトンネルリンクが作成されます。最後の ipadm コマンドは、トンネル IP インタフェース上に IPv4 アドレスと IPv6 アドレスを構成します。

# ipadm create-ip net1
# ipadm create-addr -T static -a local=10.2.3.4/24 net1/v4static
# dladm create-iptun -T ipv4 -a local=10.2.3.4,remote=10.2.3.5 tun0
# ipadm create-ip tun0 
# ipadm create-addr -T static \
       -a local=173.129.134.1,remote=173.129.134.2 tun0/v4tunaddr
# ipadm create-addr -T static \
       -a local=2ff1::3344,remote=2ff1::3345 tun0/v6tunaddr
# ipadm show-addr
ADDROBJ        TYPE   STATE     ADDR
lo0/v4         static ok        127.0.0.1/8
lo0/v6         static ok        ::/128
net1/v4static  static ok        10.2.3.4/24
tun0/v4tunaddr static ok        173.129.134.1-->173.129.134.2
tun0/v6tunaddr static ok        2ff1::3344-->2ff1::3345

例 6 すべてのインタフェースの表示

次のコマンドを使用すると、すべてのインタフェースを表示できます。

# ipadm show-if -o all
IFNAME  CLASS    STATE    ACTIVE CURRENT       PERSISTENT OVER
lo0     loopback ok       yes    -m-v------46  --46       --
net0    ip       ok       yes    bm--------46  --46       --
e1000g0 ip       ok       yes    bm---l----46  -l46       --
e1000g1 ip       ok       yes    bm---l----46  -l46       --
ipmp0   ipmp     down     yes    bm--------46  --46       e1000g0 e1000g1
tun0    ip       failed   no     -mp-------46  --46       --
vni0    vni      disabled no     bm-v--------  --46       --

例 7 インタフェースのプロパティーの表示

次のコマンドは、指定されたインタフェースのすべてのインタフェースプロパティーを表示します。

# ipadm show-ifprop net0
IFNAME PROPERTY        PROTO PERM CURRENT PERSISTENT DEFAULT  POSSIBLE
net0   arp             ipv4  rw   on      --         on       on,off
net0   forwarding      ipv4  rw   off     on         off      on,off
net0   metric          ipv4  rw   2       2          0        --
net0   mtu             ipv4  rw   1500    --         1500     68-1500
net0   exchange_routes ipv4  rw   off     --         off      on,off
net0   usesrc          ipv4  rw   none    --         none     --
net0   forwarding      ipv6  rw   off     --         off      on,off
net0   metric          ipv6  rw   2       2          0        --
net0   mtu             ipv6  rw   1500    --         1500     1280-1500
net0   nud             ipv6  rw   on      --         on       on,off
net0   exchange_routes ipv6  rw   off     on         off      on,off
net0   usesrc          ipv6  rw   none    --         none     --
net0   group           ip    rw   grp0    --         --       --
net0   standby         ip    r-   off     --         off      on,off

例 8 インタフェースごとのプロパティーの構成

次のコマンドは、インタフェース net0 の IPv4 MTU を 900 に設定します。

# ipadm set-ifprop -m ipv4 -p mtu=900 net0

次のコマンドは、インタフェース net0 の IPv6 MTU を 1400 に設定します。

# ipadm set-ifprop -m ipv6 -p mtu 1400 net0

結果を確認します。

# ipadm show-ifprop -p mtu net0
IFNAME PROPERTY        PROTO PERM CURRENT PERSISTENT DEFAULT  POSSIBLE
net0   mtu             ipv4  rw   900     900        1500     68-1500
net0   mtu             ipv6  rw   1400    1400       1500     1280-1500

# ipadm show-ifprop -m ipv6 -p mtu net0
IFNAME PROPERTY        PROTO PERM CURRENT PERSISTENT DEFAULT  POSSIBLE
net0   mtu             ipv6  rw   1400    1400       1500     1280-1500

例 9 サポートされているプロパティーの表示

次のコマンドは、TCP でサポートされているプロパティーを表示します。

# ipadm show-prop tcp
PROTO PROPERTY              PERM CURRENT PERSISTENT DEFAULT   POSSIBLE
tcp   ecn                   rw   active  active     passive   never,passive,
                                                                      active
tcp   extra_priv_ports      rw   --      1,65535    2049,4045 1-65535
tcp   largest_anon_port     rw   32768   32768      65535     1024-65535
tcp   sack                  rw   active  --         active    never,passive,
                                                                      active
tcp   recv_buf              rw   29567   --         49152     2048-1073741824
tcp   send_buf              rw   21354   --         49152     4096-1073741824
tcp   max_buf               ro   65536   --         32768     4096-1073741824
tcp   smallest_anon_port    rw   32768   --         32768     1024-65535
tcp   smallest_nonpriv_port rw   1024    --         1024      1024-32768

例 10 グローバルな IPv4 転送の構成

次の一連のコマンドは、グローバルな IPv4 転送を構成し、その設定をインタフェース net0 についてはオーバーライドします。

# ipadm set-prop -p forwarding=on ipv4
# ipadm set-ifprop -p forwarding=off -m ipv4 net0
# ipadm show-prop -p forwarding ipv4
PROTO PROPERTY              PERM CURRENT PERSISTENT DEFAULT POSSIBLE
ipv4  forwarding            rw   on      on         off     on,off

# show-ifprop -p forwarding -m ipv4 net0
IFNAME PROPERTY        PROTO PERM CURRENT PERSISTENT DEFAULT  POSSIBLE
net0   forwarding      ipv4  rw   off     off        off      on,off

例 11 set-prop サブコマンドの修飾子の使用

次の一連のコマンドは、プラス修飾子とマイナス修飾子 (+) を使用して、1047、1048、および 1049 を TCP の追加の特権ポートとして追加します。

# ipadm set-prop -p extra_priv_ports=1047 tcp
# ipadm set-prop -p extra_priv_ports+=1048 tcp
# ipadm set-prop -p extra_priv_ports+=1049 tcp
# ipadm set-prop -p extra_priv_ports+=1050 tcp

次のコマンドは、1048 を追加の特権ポートとして削除します。

# ipadm set-prop -p extra_priv_ports-=1048

次のコマンドは、TCP の追加の特権ポートをすべて表示します。

# ipadm show-prop -p extra_priv_ports tcp
PROTO PROPERTY             PERM CURRENT    PERSISTENT  DEFAULT   POSSIBLE
ipv4  extra_priv_ports     rw   1047,1049, 1047,1049,  2049,4045 1-65535
                                1050       1050

例 12 オブジェクトの有効化と無効化

次の一連のコマンドは、インタフェースオブジェクトとアドレスオブジェクトを有効または無効にし、それらの操作の結果を表示します。

# ipadm create-ip net1
# ipadm create-addr -T static -a local=10.2.3.4/24 net1/v4static
# ipadm set-addrprop -p private=yes net1/v4static
# ipadm show-addr net1/v4static
ADDROBJ        TYPE   STATE     ADDR
net1/v4static  static ok        10.2.3.4/24

次のコマンドは、アドレスオブジェクト net1/v4static を無効にします。

# ipadm disable-addr -t net1/v4static
# ipadm show-addr net1/v4static
ADDROBJ        TYPE   STATE     ADDR
net1/v4static  static ok        10.2.3.4/24

次のコマンドは、インタフェースオブジェクト net1 を無効にします。

# ipadm disable-if -t net1
# ipadm show-if net1 -o all
IFNAME     CLASS    STATE    ACTIVE CURRENT       PERSISTENT OVER
net1       ip       disabled no     bm----------  --46       --

次のコマンドは、永続的な構成を使用してインタフェースオブジェクトを有効にします。

# ipadm enable-if -t net1
# ipadm show-if net1 -o all
IFNAME     CLASS    STATE    ACTIVE CURRENT       PERSISTENT OVER
net1       ip       ok       yes    bm--------46  --46       --

# ipadm show-addr net1/v4static
ADDROBJ        TYPE   STATE     ADDR
net1/v4static  static ok        10.2.3.4/24

インタフェースオブジェクトを有効にすると、そのインタフェースに構成されているすべてのアドレスオブジェクトも有効になります。

次のコマンドは、非大域排他的 IP ゾーンの net0 インタフェースの永続的な構成を作成します。これにより、次回のリブート時に大域ゾーンから allowed-address リソースを通して提供される一連のアドレスを使用して、net0 インタフェースが構成されます。

# ipadm create-ip net0

次のコマンドを実行すると、リブートしなくても、非大域排他的 IP ゾーンで使用可能な一連の allowed-address 値を使用して net0 インタフェースを構成できます。

# ipadm disable-if -t net0
# ipadm enable-if -t net0

例 13 IPMP インタフェースの作成

次の一連のコマンドは、IPMP インタフェースを作成し、基になるインタフェースを追加します。

# ipadm create-ip e1000g0
# ipadm create-ip e1000g1
# ipadm create-ip e1000g2
# ipadm set-ifprop -p standby=on -m ip e1000g2
# ipadm create-ipmp testgroup0
# ipadm add-ipmp -i e1000g0 -i e1000g1 -i e1000g2 testgroup0
# ipadm create-addr -T static -a local=192.168.80.5/24 testgroup0/data1
# ipadm create-addr -T static -a local=192.168.80.6/24 testgroup0/data2
# ipadm show-if
IFNAME     CLASS    STATE    ACTIVE OVER
lo0        loopback ok       yes    --
net0       ip       ok       yes    --
e1000g0    ip       ok       yes    --
e1000g1    ip       ok       yes    --
ipmp0      ipmp     ok       yes    e1000g0 e1000g1

次の一連のコマンドは、IPMP インタフェースを無効にしてから有効にします。

# ipadm disable-if -t testgroup0
ipadm show-if
IFNAME     CLASS    STATE    ACTIVE OVER
lo0        loopback ok       yes    --
net0       ip       ok       yes    --
e1000g0    ip       disabled no     --
e1000g1    ip       disabled no     --
ipmp0      ipmp     disabled no     e1000g0 e1000g1
# ipadm enable-if -t testgroup0

次の一連のコマンドは、IPMP インタフェースから基になるインタフェースを削除したあとで、IPMP インタフェースを削除します。

ipadm remove-ipmp -i e1000g0 -i e1000g1 testgroup0
ipadm delete-ipmp testgroup0

例 14 ヘルプの表示

次のコマンドは、引数なしの help サブコマンドの使用を示します。

# ipadm help
The following subcommands are supported:
Address subcommands           : create-addr, delete-addr, disable-addr,
                                down-addr, enable-addr, refresh-addr,
                                reset-addrprop, set-addrprop, show-addr,
                                show-addrprop, up-addr
Interface subcommands         : disable-if, enable-if, reset-ifprop,
                                set-ifprop, show-if, show-ifprop
IP interface subcommands      : create-ip, delete-ip
IPMP interface subcommands    : add-ipmp, create-ipmp, delete-ipmp,
                                remove-ipmp
Protocol property subcommands : reset-prop, set-prop, show-prop
VNI interface subcommands     : create-vni, delete-vni
For more info, run: ipadm help subcommand

次のコマンドは、サブコマンド引数を指定した help サブコマンドの使用を示します。

# ipadm help create-ipmp
usage:
    create-ipmp    [-t] [-i under-interface[,...]]
    ... IPMP-interface

example:
    # ipadm create-ipmp -i net0,net1 ipmp0

属性

属性についての詳細は、マニュアルページの attributes(5) を参照してください。

属性タイプ
属性値
使用条件
system/core-os
インタフェースの安定性
確実

関連項目

read(1), arp(1M), cfgadm(1M), dhcpagent(1M), dladm(1M), if_mpadm(1M), ifconfig(1M), in.ndpd(1M), in.mpathd(1M), ndd(1M), netadm(1M), netcfg(1M), zonecfg(1M), nsswitch.conf(4), attributes(5), dhcp(5), vni(7d)

Oracle Solaris Tunable Parameters Reference Manual

RFC 791, Internet Protocol - DARPA Internet Program Protocol Specification』、Postel, J. (Information Sciences Institute, University of Southern California) 著、1981 年 9 月

Hinden, R. および S.Deering 著、『IP Version 6 Addressing Architecture』(RFC 4291)、2006 年 2 月

Thomson, S.、Narten, T.、および T.Jinmei 著、『IPv6 Stateless Address AutoConfiguration』(RFC 4862)、2007 年 9 月

Droms, R.、Bound, J.、Volz, B.、Lemon, T.、Perkins, C.、および M.Carney 著、『Dynamic Host Configuration Protocol for IPv6 (DHCPv6)』(RFC 3315)、2003 年 7 月

Narten, T.、Draves, R.、および S.Krishnan 著、『Privacy Extensions for Stateless Address AutoConfiguration in IPv6』(RFC 4941)、2007 年 9 月

政府のRouthier, Ed. 著、『Management Information Base for the Internet Protocol (IP)』(RFC 4293)、2006 年 4 月

Requirements for Internet Hosts - Communication Layers』(RFC 1122)、Braden, R. (Information Sciences Institute, University of Southern California) 著、1989 年 10 月