JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
man pages section 1M: System Administration Commands     Oracle Solaris 11 Express 11/10
search filter icon
search icon

Document Information

Preface

Introduction

System Administration Commands - Part 1

6to4relay(1M)

accept(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)

add_install_client(1M)

add_to_install_server(1M)

afbconfig(1M)

apache(1M)

arp(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)

cachefsd(1M)

cachefslog(1M)

cachefspack(1M)

cachefsstat(1M)

cachefswssize(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)

cfsadmin(1M)

chargefee(1M)

chat(1M)

check(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)

consadm(1m)

conv_lp(1M)

conv_lpd(1M)

coreadm(1M)

cpustat(1M)

cron(1M)

cryptoadm(1M)

cvcd(1M)

datadm(1M)

dcopy(1M)

dcs(1M)

dd(1M)

devattr(1M)

devfree(1M)

devfsadm(1M)

devfsadmd(1M)

device_allocate(1M)

device_remap(1M)

devinfo(1M)

devlinks(1M)

devnm(1M)

devprop(1M)

devreserv(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)

disks(1M)

diskscan(1M)

dispadmin(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)

etrn(1M)

fbconfig(1M)

fbconf_xorg(1M)

fcadm(1M)

fcinfo(1M)

fdetach(1M)

fdisk(1M)

ff(1M)

ffbconfig(1M)

ff_ufs(1M)

fingerd(1M)

fiocompress(1M)

flar(1M)

flarcreate(1M)

flowadm(1M)

flowstat(1M)

fmadm(1M)

fmd(1M)

fmdump(1M)

fmstat(1M)

fmthard(1M)

format(1M)

fpsd(1M)

fruadm(1M)

fsck(1M)

fsck_cachefs(1M)

fsck_pcfs(1M)

fsck_udfs(1M)

fsck_ufs(1M)

fsdb(1M)

fsdb_udfs(1M)

fsdb_ufs(1M)

fsirand(1M)

fssnap(1M)

fssnap_ufs(1M)

fsstat(1M)

fstyp(1M)

ftpaddhost(1M)

ftpconfig(1M)

ftpd(1M)

ftprestart(1M)

ftpshut(1M)

fuser(1M)

fwflash(1M)

fwtmp(1M)

getdev(1M)

getdevpolicy(1M)

getdgrp(1M)

getent(1M)

gettable(1M)

getty(1M)

getvol(1M)

GFXconfig(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)

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.ftpd(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)

installboot(1M)

installer(1M)

installf(1M)

installgrub(1M)

install_scripts(1M)

install-solaris(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)

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)

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)

listdgrp(1M)

listen(1M)

llc2_loop(1M)

lms(1M)

localeadm(1M)

localectr(1M)

locator(1M)

lockd(1M)

lockfs(1M)

lockstat(1M)

lofiadm(1M)

logadm(1M)

logins(1M)

lpadmin(1M)

lpfilter(1M)

lpforms(1M)

lpget(1M)

lpmove(1M)

lpsched(1M)

lpset(1M)

lpshut(1M)

lpsystem(1M)

lpusers(1M)

lu(1M)

luactivate(1M)

lucancel(1M)

lucompare(1M)

lucreate(1M)

lucurr(1M)

ludelete(1M)

ludesc(1M)

lufslist(1M)

lumake(1M)

lumount(1M)

lurename(1M)

lustatus(1M)

luumount(1M)

luupgrade(1M)

luxadm(1M)

m64config(1M)

mail.local(1M)

System Administration Commands - Part 2

System Administration Commands - Part 3

dlstat

- report data links statistics

Synopsis

dlstat [-r | -t] [-i interval] [link]
dlstat [-a | -A] [-i interval] [-p] [ -o field[,...]]
     [-u R|K|M|G|T|P]  [link]
dlstat show-phys [-r | -t] [-i interval] [-a]
     [-p] [-o field[,...]] [-u R|K|M|G|T|P] [link]
dlstat show-link [-r [-F] | -t] [-i interval] [-a]
     [-p] [-o field[,...]] [-u R|K|M|G|T|P] [link]
dlstat show-link -h [-a] -f filename [-d] [-F format] [-s time]
          [-e time] [link]
dlstat show-aggr [-r | -t] [-i interval] [-p] [-o field[,...]]
     [-u R|K|M|G|T|P] [link]

Description

The dlstat command reports run time statistics about data links. dladm(1M) show-phys provides link-name information to dlstat show-phys. dladm(1M) show-link provides link-name information to dlstat show-link. dladm(1M) show-aggr provides link-aggregation information to dlstat show-aggr.

dlstat has the six forms of commands shown in the SYNOPSIS, above. The first two forms do not have subcommands, while the remain forms do. All six forms are described under “Subcommands,” below.

Options

The dlstat command has the following options and operands that are common among a number of command forms shown under “Subcommands,” below.

-a

Dump all total statistics fields.

-i interval

Specify an interval in seconds at which statistics are refreshed. The default interval is one second.

-o field[,...]

Display a case-insensitive, comma-separated list of output fields to display. The field name must be one of the fields listed below, or the special value all to display all supported fields.

List of supported RX fields:

  • link

  • iusedby

  • ibytes

  • ipkts

  • intrs

  • polls

  • hdrops: hardware drops

  • sdrops: software drops (owing to bandwidth enforcement)

  • ch<10: number of packet chains of length < 10

  • ch10-50: number of packet chains of length between 10 and 50

  • ch>50: number of packet chains of length > 50

List of TX side fields:

  • link

  • obytes

  • opackets

  • oerrors

  • opktdrop

  • blkcnt

  • ublkcnt

-p

Display output in a stable, machine-parseable format.

-r

Display receive-side statistics only. Includes bytes and packets received, hardware and software drops, and so forth. See “Examples” for complete listing.

-t

Display transmit-side statistics only. Includes bytes and packets sent, hardware and software drops, and so forth. See “Examples” for complete listing.

-u R|K|M|G|T|P

If used, allows choosing the unit in which to display all statistics, for example, R:raw count, K:Kilobits, M:Megabits, T:Terabits, P:Petabits. If not used, then different units, as appropriate, are used to display the statistics, using the format xy.zU, where x, y, and z are numbers and U is the appropriate unit.

link

If specified, display the statistics only for the named link, physical device (for show-phys), or aggregation (for show-aggr). Otherwise, display statistics for all links, devices, or aggregations.

Sub-commands

dlstat supports the following command forms.

dlstat [-r | -t] [-i interval] [link]

Iteratively examine all links and report statistics. The output is sorted in descending order of link utilization. If no link is specified, the system displays statistics for all links. The traffic statistics are displayed per link and not per physical device. For example, for a VNIC configured on a physical link, traffic flowing through that VNIC is not reflected in the statistics for the underlying physical link. However, the link statistics will include traffic that matches user-defined flows configured on top of that link.

This command form has one option that is not described under “Options,” above:

-A

Dump all statistics fields for this data-link. Output statistics of this command are inclusive of all the statistics reported by all other dlstat commands.

dlstat [-a | -A] [-i interval] [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link]

Allows specifying which statistics to display.

The options for this command form are described under “Options,” above.

dlstat show-phys [-r | -t] [-i interval] [-a] [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link]

Display statistics for a physical device.

The options for this subcommand are described under “Options,” above.

dlstat show-link [-r [-F] | -t] [-i interval] [-a] [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link]

Display statistics for a link.

This subcommand has one option not described under “Options,” above:

-F

Display software fanout statistics.

dlstat show-link -h [-a] -f filename [-d] [-F format] [-s time] [-e time] [link]

Show the network usage history from a stored extended accounting file. Use of this syntax requires that net accounting has been previously configured and enabled by using acctadm(1M). The default output is the summary of network usage of the existing links for the entire period when extended accounting was enabled.

The link argument is as described under “Options,” above.

-a

Display all historical network usage for the specified period when extended accounting is enabled. This includes usage information about links that have already been deleted.

-f filename

Specify the file from which extended accounting records of network usage history are read.

-d

Display the dates for which there is logging information. The date is in the format mm/dd/yyyy.

-F format

Specify the output format of the network usage history information. gnuplot is the only supported format.

-s time
-e time

Specify start and stop times for data display. Time is in the format MM/DD/YYYY,hh:mm:ss. hh uses 24-hour clock notation.

dlstat show-aggr [-r | -t] [-i interval] [-p] [ -o field[,...]] [-u R|K|M|G|T|P] [link]

Display per-port statistics for an aggregation.

The options for this subcommand are described under “Options,” above.

Examples

Example 1 Displaying Statistics

To display statistics for all the links, enter following command. Statistics are displayed as 3-digits followed by decimal and then 2 digits with the appropriate unit.

# dlstat
LINK   IPKTS  RBYTES   OPKTS  OBYTES
e1000g0 101.88K  32.86M  40.16K   4.37M
  nxge1   4.50M   6.78G   1.38M  90.90M
  vnic1       8     336       0       0

Example 2 Displaying RX-side Statistics

The following command displays receive-side statistics every one second.

# dlstat -r -i 1
   LINK   IPKTS  RBYTES   INTRS   POLLS   CH<10 CH10-50   CH>50
e1000g0 101.91K  32.86M  87.56K  14.35K   3.70K     205       5
  nxge1   9.61M  14.47G   5.79M   3.82M 379.98K  85.66K   1.64K
  vnic1       8     336       0       0       0       0       0
e1000g0       0       0       0       0       0       0       0
  nxge1  82.13K 123.69M  50.00K  32.13K   3.17K     724      24
  vnic1       0       0       0       0       0       0       0
    .       .       .       .       .       .       .       .
    .       .       .       .       .       .       .       .
    .       .       .       .       .       .       .       .

Example 3 Displaying Statistics per Hardware Ring

The following commands displays statistics on a per receive-side hardware ring basis.

# dlstat show-phys -r nxge1
 LINK TYPE INDEX   IPKTS  RBYTES
nxge1   rx     0      21   1.79K
nxge1   rx     1       0       0
nxge1   rx     2   1.39M   2.10G
nxge1   rx     3       0       0
nxge1   rx     4   6.81M  10.26G
nxge1   rx     5   4.63M   6.97G
nxge1   rx     6   3.97M   5.98G
nxge1   rx     7       0       0

Example 4 Displaying Statistics per Lane

The following commands displays statistics on a per receive-side lane basis. First, an interface with dedicated hardware lanes:

# dlstat show-link -r nxge1
 LINK TYPE     ID INDEX   IPKTS  RBYTES   INTRS   POLLS   CH<10 CH10-50   CH>50
nxge1   rx  local    --       0       0       0       0       0       0       0
nxge1   rx     hw     1       0       0       0       0       0       0       0
nxge1   rx     hw     2   1.73M   2.61G   1.33M 400.22K  67.03K   7.49K      38
nxge1   rx     hw     3       0       0       0       0       0       0       0
nxge1   rx     hw     4   8.44M  12.71G   4.35M   4.09M 383.28K  91.24K   2.09K
nxge1   rx     hw     5   5.68M   8.56G   3.72M   1.97M 203.68K  43.94K     854
nxge1   rx     hw     6   4.90M   7.38G   3.11M   1.80M 168.59K  42.34K     620
nxge1   rx     hw     7       0       0       0       0       0       0       0

Then, an interface without dedicated hardware lanes, that is, a software lane only:

# dlstat show-link -r ixgbe0
  LINK TYPE     ID INDEX   IPKTS  RBYTES   INTRS   POLLS   CH<10 CH10-50   CH>50
ixgbe0   rx  local    --       0       0       0       0       0       0  0
ixgbe0   rx     sw    -- 794.28K   1.19G 794.28K       0       0       0  0

Example 5 Displaying Receive-Side Fanout Statistics

The following command displays receive-side fanout statistics. Consider a 10 Gb Ethernet card configured to run with only two of the available RX rings.

# dlstat show-link -r -F vnic1
  LINK     ID INDEX  FOUT   IPKTS
ixgbe0  local    --     0       0
ixgbe0     hw     0     0 382.47K
ixgbe0     hw     0     1       0
ixgbe0     hw     1     0 367.50K
ixgbe0     hw     1     1 433.24K

Example 6 Displaying Transmit-Side Statistics

The following command displays transmit-side statistics at five-second intervals.

# dlstat -t -i 5
   LINK   OPKTS  OBYTES  BLKCNT UBLKCNT
e1000g0  40.24K   4.37M       0       0
  nxge1   9.76M 644.14M       0       0
  vnic1       0       0       0       0
e1000g0       0       0       0       0
  nxge1  26.82K   1.77M       0       0
  vnic1       0       0       0       0
      .       .       .       .       .
      .       .       .       .       .
      .       .       .       .       .

Example 7 Displaying Transmit-Side Ring Statistics

The following command displays transmit-side hardware ring statistics.

# dlstat show-phys -t nxge1
 LINK TYPE INDEX   OPKTS  OBYTES
nxge1   tx     0      44   3.96K
nxge1   tx     1       0       0
nxge1   tx     2   1.48M 121.68M
nxge1   tx     3   2.45M 201.11M
nxge1   tx     4   1.47M 120.82M
nxge1   tx     5       0       0
nxge1   tx     6   1.97M 161.57M
nxge1   tx     7   4.59M 376.21M
nxge1   tx     8   2.43M 199.24M
nxge1   tx     9       0       0
nxge1   tx     10  3.23M 264.69M
nxge1   tx     11  1.88M 153.96M

Example 8 Displaying Transmit-Side Lane Statistics

The following command displays transmit-side lane statistics.

# dlstat show-link -t nxge1
 LINK TYPE     ID INDEX   OPKTS  OBYTES  BLKCNT UBLKCNT
nxge1   tx     hw     0      32   1.44K       0       0
nxge1   tx     hw     1       0       0 0       0
nxge1   tx     hw     2   1.48M  97.95M       0       0
nxge1   tx     hw     3   2.45M 161.87M       0       0
nxge1   tx     hw     4   1.47M  97.25M       0       0
nxge1   tx     hw     5       3     276       0       0
nxge1   tx     hw     6   1.97M 130.05M       0       0
nxge1   tx     hw     7   4.59M 302.80M       0       0
nxge1   tx     hw     8   2.42M 302.80M       0       0
nxge1   tx     hw     9       0       0       0       0
nxge1   tx     hw     10  3.23M 213.05M       0       0
nxge1   tx     hw     11  1.88M 123.93M       0       0

Example 9 Selecting a Particular Set of Statistics

The following command shows how you can select a set of statistics of particular interest.

# dlstat show-link -r -o LINK,TYPE,ID,INDEX,INTRS,POLLS nxge1
 LINK TYPE     ID INDEX   INTRS   POLLS
nxge1   rx  local    --       0       0
nxge1   rx     hw     1       0       0
nxge1   rx     hw     2   2.47M 753.90K
nxge1   rx     hw     3       0       0
nxge1   rx     hw     4   8.24M   7.72M
nxge1   rx     hw     5   6.96M   3.68M
nxge1   rx     hw     6   5.82M   3.36M
nxge1   rx     hw     7       0       0

Example 10 Displaying Historical Network Usage

Network usage history statistics can be stored by using the extended accounting facility, acctadm(1M), with a command such as the following:

# acctadm -e basic -f /var/log/net.log net
acctadm net
Network accounting: active
    Network accounting file: /var/log/net.log
  Tracked Network resources: basic
Untracked Network resources: src_ip,dst_ip,src_port,dst_port,protocol,
                             dsfield

The saved historical data can then be retrieved in summary form with a command such as the following:

# dlstat show-link -h -f /var/log/net.log
LINK      DURATION  IPACKETS RBYTES      OPACKETS OBYTES      BANDWIDTH
e1000g0   80        1031     546908      0        0           2.44 Kbps

Attributes

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

/usr/sbin

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
SUNWcsu
Interface Stability
See below

Screen output is Uncommitted. The invocation is Committed.

See Also

acctadm(1M), dladm(1M), ifconfig(1M), kstat(1M), netstat(1M), attributes(5)