acctadm(1M)

名称

acctadm - 配置扩展记帐工具

用法概要

/usr/sbin/acctadm [-DEsrux] [-d resource_list] 
     [-e resource_list] [-f filename] 
     [task | process | flow | net]

描述

acctadm 可配置扩展记帐工具的各种属性。如果不带任何参数，acctadm 将显示扩展记帐工具的当前状态。

选项

支持以下选项：

–d resource_list

禁止报告资源的使用情况。以逗号分隔的资源或资源组列表形式指定 resource_list。

该选项需要一个操作数。请参见“操作数”部分。

–D

禁止对给定操作数类型进行记帐，而不关闭记帐文件。可以使用该选项临时停止将记帐记录写入到记帐文件，而不关闭该文件。要关闭该文件，请使用 –x 选项。请参见 –x。

–e resource_list

允许报告资源的使用情况。以逗号分隔的资源或资源组列表形式指定 resource_list。

该选项需要一个操作数。请参见“操作数”部分。

–E

允许对给定操作数类型进行记帐，而不将记帐输出发送到文件。该选项需要一个操作数。请参见“操作数”部分。

–f filename

将给定操作数类型的记帐输出发送到 filename。如果 filename 存在，其内容必须为给定记帐类型。

该选项需要一个操作数。请参见“操作数”部分。

–r

显示可用资源组。

如果将该选项与操作数一起使用，它将显示可用于给定记帐类型的资源组。如果不指定任何操作数，该选项将显示所有可用记帐类型的资源组。请参见“操作数”部分。

–s

启动 smf(5) 实例的方法。该选项用于在引导时恢复扩展记帐配置。

–x

取消激活给定操作数类型的记帐。如果给定记帐类型的记帐文件当前处于打开状态，该选项还将关闭该文件。

该选项需要一个操作数。请参见“操作数”部分。

操作数

–d、–D、–e、–E、–f 和 –x 选项都需要一个操作数。

支持下列操作数：

process

在扩展记帐工具的进程记帐组件上运行 acctadm。

task

在扩展记帐工具的任务记帐组件上运行 acctadm。

flow

在扩展记帐工具的 IPQoS 记帐组件上运行 acctadm。

net

分别在由 dladm(1M) 和 flowadm(1M) 管理的链路和流上运行 acctadm。基本网络记帐仅与链路相关，而扩展网络记帐包括链路记帐和流记帐。

acctadm 的可选最终参数表示该命令是否应对扩展记帐工具的进程、系统任务、IPQoS 或网络记帐组件起作用。

示例

示例 1 显示当前状态

以下命令将显示当前状态。在此示例中，系统任务记帐处于活动状态并仅跟踪 CPU 资源。进程记帐和流记帐未处于活动状态。

$ acctadm
            Task accounting: active
       Task accounting file: /var/adm/exacct/task
     Tracked task resources: extended
   Untracked task resources: host
         Process accounting: inactive
    Process accounting file: none
  Tracked process resources: none
Untracked process resources: extended,host
            Flow accounting: inactive
       Flow accounting file: none
     Tracked flow resources: none
   Untracked flow resources: extended
             Net accounting: inactive
        Net accounting file: none
      Tracked Net resources: none
    Untracked Net resources: extended

示例 2 激活基本进程记帐

以下命令激活基本进程记帐：

$ acctadm -e basic -f /var/adm/exacct/proc process

示例 3 显示可用资源组

以下命令显示可用资源组：

$ acctadm -r
  process:
  extended pid,uid,gid,cpu,time,command,tty,projid, \ 
  taskid,ancpid,wait-status,zone,flag,memory,mstate
  basic    pid,uid,gid,cpu,time,command,tty,flag
  task:
  extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
  basic    taskid,projid,cpu,time
  flow:
  extended saddr,daddr,sport,dport,proto,dsfield,nbytes,npkts, \
  action,ctime,lseen,projid,uid
  basic    saddr,daddr,sport,dport,proto,nbytes,npkts,action
  net:
  extended name,devname,edest,vlan_tpid,vlan_tci,sap,cpuid, \
  priority,bwlimit,curtime,ibytes,obytes,ipkts,opks,ierrpkts \
  oerrpkts,saddr,daddr,sport,dport,protocol,dsfield
  basic    name,devname,edest,vlan_tpid,vlan_tci,sap,cpuid, \
  priority,bwlimit,curtime,ibytes,obytes,ipkts,opks,ierrpkts \
  oerrpkts

在以上输出中，以 extended 开头的行显示有反斜杠字符。在实际 acctadm 输出中，这些行显示为连续的长行。

示例 4 显示任务记帐的资源组

以下命令显示任务记帐的资源组：

$ acctadm -r task
  extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
  basic    taskid,projid,cpu,time

退出状态

将返回以下退出值：

0

成功完成。

对当前配置进行的修改有效且已成功进行修改。

1

出现错误。

获取或修改记帐配置时发生致命错误。

2

指定的命令行选项无效。

95

启动 smf(5) 服务实例期间发生致命的非配置错误。

96

启动 smf(5) 服务实例期间发生致命的配置错误。

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 system/core-os 接口稳定性 Committed（已确定）

另请参见

dladm(1M)、flowadm(1M)、acct(2)、attributes(5)、smf(5)、ipqos(7ipp)

附注

扩展记帐和常规记帐均可处于活动状态。

可用资源可能因不同的系统和平台而有所差异。

扩展记帐配置存储在服务管理工具 (smf(5)) 系统信息库中。在引导时，该配置将由瞬态服务实例恢复（每个记帐类型具有一个实例）：

svc:/system/extended-accounting:flow        Flow accounting
svc:/system/extended-accounting:process     Process accounting
svc:/system/extended-accounting:task        Task accounting
svc:/system/extended-accounting:net         Network accounting

这些实例可由 acctadm 根据需要启用或禁用。使用 acctadm 进行配置更改；不应使用 svccfg(1M) 直接修改服务属性。

如果用户对要管理的记帐类型具有相应的 RBAC 权限配置文件，则可以管理扩展记帐（启动记帐、停止记帐以及更改记帐配置参数）：

• 扩展记帐流管理

• 扩展记帐进程管理

• 扩展记帐任务管理

• 扩展记帐网络管理

上述的配置文件分别用于流记帐、进程记帐、任务记帐和网络记帐。