手册页部分 1M: 系统管理命令

退出打印视图

更新时间: 2014 年 7 月
 
 

add_allocatable(1M)

名称

add_allocatable - 向分配数据库添加条目

用法概要

/usr/sbin/add_allocatable [-f] [-s] [-d] -n name -t type -l device-list 
    [-a authorization] [-c clean] [-o key=value]

描述

add_allocatable 为由设备分配机制管理的用户可分配设备创建新条目。add_allocatable 还可用于更新此类设备的现有条目。

add_allocatable 还可以为标签范围由设备分配机制管理的不可分配设备(例如打印机)创建和更新条目。

add_allocatable 可以在 shell 脚本(例如驱动程序软件包的安装脚本)中使用,以自动完成设置新设备的管理工作。

可使用 list_devices(1) 查看可分配设备的名称和类型、属性以及设备路径。

选项

–f

强制使用指定的信息更新现有条目。如果具有指定设备名称的条目已存在时未指定此选项,则 add_allocatable 会退出并显示错误。

–s

打开无提示模式。add_allocatable 不输出任何错误或警告消息。

–d

如果此选项存在,则 add_allocatable 会更新 –t 所指定设备类型的系统提供的缺省属性。

–n name

添加或更新 name 指定的设备的条目。

–t type

添加或更新 type 所指定类型的设备条目。

–l device-list

添加或更新 –n 所指定设备的设备路径。device-list 中的多个路径必须由空格分隔,列表必须使用引号引起来。

–a authorization

添加或更新与 –n 所指定的设备或 –t 所指定类型的设备关联的授权。如果指定了多个授权,则列表必须由逗号分隔,并且必须使用引号引起来。设备不可分配时,authorization 通过星号 (*) 指定,并且必须使用引号引起来。设备可由任何用户分配时,authorization 通过 at 符号 (@) 指定,并且必须使用引号引起来。缺省授权为 '@'。

–c clean

指定要与 –n 所指定的设备或 –t 所指定类型的设备一起使用的 device_clean(5) 程序 clean。缺省清除程序为 /bin/true

–o key=value

针对 –n 所指定的设备或 –t 所指定类型的设备接受冒号分隔的 key=value 对字符串。以下关键字当前由系统解释:

minlabel

可以在此处使用设备的最小标签。

maxlabel

可以在此处使用设备的最大标签。

class

指定设备的逻辑分组。例如,所有设备类型的所有 Sun Ray 设备是一个逻辑分组。class 关键字无缺省值。

xdpy

指定 X 会话的显示名称。此关键字用于标识与 X 会话关联的设备。xdpy 关键字无缺省值。

退出状态

如果成功,add_allocate 将返回退出状态 0 (true)。如果出错,add_allocate 将返回非零退出状态。退出代码如下:

1

调用语法错误

2

未知系统错误

3

指定设备的条目已存在。仅在未指定 –f 选项时才会发生此错误。

4

权限被拒绝。用户不具有 DAC 或 MAC 访问记录更新权限。

属性

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

属性类型
属性值
可用性
system/trusted
接口稳定性
请参见下文。

调用为 "Uncommitted"(未确定)。选项为 "Uncommitted"(未确定)。输出为 "Not-an-Interface"(不是接口)。

另请参见

allocate(1)deallocate(1)list_devices(1)remove_allocatable(1M)attributes(5)device_clean(5)

附注

仅当系统配置有 Trusted Extensions 时,本手册页中介绍的功能才可用。