allocate(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DIAGNOSTICS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO

NAME

allocate- Device Allocation

SYNOPSIS

allocate [-s] [-U uname] device
allocate [-s] [-U uname] -g dev -type
allocate [-s] [-U uname] -F device

DESCRIPTION

allocate manages the ownership of devices through its allocation mechanism. It ensures that each device is used by only one qualified user at a time.

The device argument specifies the device to be manipulated. To preserve the integrity of the device's owner, the allocate operation is executed on all the device-special files associated with that device.

The argument dev-type, is the device type to be operated on. The argument dev-type, can only be used with the -g option.

The default allocate operation, allocates the device-special files associated with device to the UID of the current process.

If the -F option is specified, the device cleaning program is executed when allocation is performed. This cleaning program is found in /etc/security/lib. The name of this program is found in the device_allocate(4) entry for the device in the dev-exec field.

OPTIONS

-g dev-type

Allocate a non-allocated device with a device-type matching dev-type.

-s

Silent. Suppresses any diagnostic output.

-F device

Reallocate the device allocated to another user. This option is often used with -U to reallocate a specific device to a specific user. This option requires the sys_devices privilege to work.

-U uname

Use the user ID uname instead of the user ID of the current process when performing the allocate operation. This option requires the sys_devices privilege to work.

DIAGNOSTICS

allocate returns an nonzero exit status in the event of an error.

FILES

/etc/security/device_allocate

Mandatory access control file for devices.

/etc/security/device_maps

List of physical devices associated with a device name and type.

/etc/security/dev/*

Device storage area.

/etc/security/lib/*

Directory of device cleaning scripts.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWcsu

SUMMARY OF TRUSTED SOLARIS CHANGES

The -F and -U options require the sys_devices privilege to work.

SEE ALSO

Trusted Solaris 7 Reference Manual

device_allocate(4), device_maps(4)

SunOS 5.7 Reference Manual

attributes(5)

Trusted Solaris 7  Last Revised 15 Nov 1996

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | DIAGNOSTICS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO