Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

allocate(1) [mojave man page]

allocate(1)                                                                                                                            allocate(1)

NAME

       allocate - device allocation

SYNOPSIS

       allocate [-s] [-U uname] device

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

       allocate [-s] [-U uname] -F device

       The  allocate  utility  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 exe-
       cuted on all the device special files associated with that device.

       The argument dev-type is the device type to be operated on and 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.

       Only authorized users may allocate a device. The required authorizations are specified in device_allocate(4).

       The following options are supported:

       -g dev-type     Allocates a non-allocated device with a device-type matching dev-type.

       -s              Silent. Suppresses any diagnostic output.

       -F device       Reallocates the device allocated to another user. This option is often used with -U to reallocate a specific  device  to  a
                       specific user. Only a user with the solaris.device.revoke authorization is permitted to use this option.

       -U uname        Uses  the  user  ID uname instead of the user ID of the current process when performing the allocate operation. Only a user
                       with the solaris.device.revoke authorization is permitted to use this option.

       The following exit values are returned:

       non--zero       An error occurred.

       /etc/security/device_allocate

       /etc/security/device_maps

       /etc/security/dev/*

       /etc/security/lib/*

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWcsu                      |
       +-----------------------------+-----------------------------+

       deallocate(1), list_devices(1), bsmconv(1M), dminfo(1M), mkdevalloc(1M), mkdevmaps(1M), device_allocate(4), device_maps(4), attributes(5)

       The functionality described in this man page is available only if the Basic Security Module (BSM) has been  enabled.  See  bsmconv(1M)  for
       more information.

       /etc/security/dev, mkdevalloc(1M), and mkdevmaps(1M) might not be supported in a future release of the Solaris Operating Environment.

                                                                    28 Mar 2005                                                        allocate(1)

Check Out this Related Man Page

deallocate(1)															     deallocate(1)

NAME

       deallocate - device deallocation

SYNOPSIS

       deallocate [-s] device

       deallocate [-s] [-F] device

       deallocate [-s] -I

       The  deallocate utility deallocates a device allocated to the evoking user. device can be a device defined in  device_allocate(4) or one of
       the device special files associated with the device. It resets the ownership and the permission on all device special files associated with
       device, disabling the user's access to that device. This option can be used by an authorized user to remove access to the device by another
       user. The required authorization is solaris.device.allocate.

       When deallocation or forced deallocation is performed, the appropriate device cleaning program is  executed,  based  on	the   contents	of
       device_allocate(4).  These cleaning programs are normally stored in /etc/security/lib.

       The following options are supported:

       device	       Deallocate the device associated with the device special file specified by device.

       -s	       Silent. Suppresses any diagnostic output.

       -F device       Forces  deallocation of the device associated with the file specified by device. Only a user with the solaris.device.revoke
		       authorization is permitted to use this option.

       -I	       Forces deallocation of all allocatable devices. Only a user with the solaris.device.revoke authorization  is  permitted	to
		       use this option. This option should only be used at system initialization.

       The following exit values are returned:

       non--zero       An error occurred.

       /etc/security/device_allocate

       /etc/security/device_maps

       /etc/security/dev/*

       /etc/security/lib/*

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

       allocate(1), list_devices(1), bsmconv(1M), dminfo(1M), mkdevalloc(1M), mkdevmaps(1M), device_allocate(4), device_maps(4), attributes(5)

       The  functionality  described  in  this man page is available only if the Basic Security Module (BSM) has been enabled. See bsmconv(1M) for
       more information.

       /etc/security/dev, mkdevalloc(1M), and mkdevmaps(1M) might not be supported in a future release of the Solaris Operating Environment.

								    28 Mar 2005 						     deallocate(1)
Man Page