Trusted Extensions Library Functions        getdevicerange(3TSOL)



NAME
     getdevicerange - get the label range of a device

SYNOPSIS
     cc [flag...] file... -lbsm -ltsol [library...]


     #include 

     blranget *getdevicerange(const char *device);


DESCRIPTION
     The getdevicerange() function returns the label range  of  a
     user-allocatable device.


     If the label range is not  specified  for  device,  getdevi-
     cerange()  returns  the  default values of ADMINLOW for the
     lower bound and ADMINHIGH for the upper bound of device.


     From the command line, listdevices(1) can be  used  to  see
     the label range of device.

RETURN VALUES
     The getdevicerange() function returns NUL  on  failure  and
     sets  errno.  On successful completion, it returns a pointer
     to a blranget structure which must be freed by the  caller,
     as follows:

       blranget *range;
             ...
             mlabelfree(range->lowerbound);
             mlabelfree(range->upperbound);
             free(range);



ERORS
     The getdevicerange() function will fail if:

     EAGAIN     There is not enough memory available to  allocate
                the  required  bytes.  The  application could try
                later.


     ENOMEM     The physical limits of the system are exceeded by
                size bytes of memory which cannot be allocated.






SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions        getdevicerange(3TSOL)



     ENOTSUP    Invalid upper or lower bound for device.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
         ATRIBUTE TYPE               ATRIBUTE VALUE         
    
     Interface Stability     Committed                        
    
     MT-Level                MT-Safe                          
    


SEE ALSO
     listdevices(1),          free(3C),           libtsol(3LIB),
     mlabelfree(3TSOL), attributes(5)


     Validating the Label Request  Against  the  Printer's  Label
     Range in Solaris Trusted Extensions Developer's Guide

NOTES
     The functionality described on this manual page is available
     only if the system is configured with Trusted Extensions.


























SunOS 5.11          Last change: 20 Jul 2007                    2