Kernel Functions for Drivers               ddidmasetsbus64(9F)



NAME
     ddidmasetsbus64 - allow 64-bit transfers on SBus

SYNOPSIS
     #include 
     #include 



     int ddidmasetsbus64(ddidmahandlet handle, uintt burstsizes);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     handle         The  handle  filled   in   by   a   call   to
                    ddidmaallochandle(9F).


     burstsizes     The possible burst  sizes  the  device's  DMA
                    engine can accept in 64-bit mode.


DESCRIPTION
     ddidmasetsbus64() informs  the  system  that  the  device
     wishes  to  perform  64-bit  data transfers on the SBus. The
     driver   must   first   allocate   a    DMA   handle   using
     ddidmaallochandle(9F)  with  a ddidmaattr(9S) structure
     describing the  DMA attributes for a 32-bit transfer mode.


     burstsizes describes the possible burst sizes  the  device's
     DMA  engine  can  accept in 64-bit mode. It may be  distinct
     from  the  burst  sizes  for  32-bit   mode   set   in   the
     ddidmaattr(9S)  structure. The system will activate 64-bit
     SBus transfers if the SBus  supports  them.  Otherwise,  the
     SBus will operate in 32-bit mode.


     After    DMA   resources   have    been    allocated    (see
     ddidmaaddrbindhandle(9F)                              or
     ddidmabufbindhandle(9F)), the driver should retrieve the
     available  burst  sizes  by calling  ddidmaburstsizes(9F).
     This function will return the burst sizes  in 64-bit mode if
     the  system  was able to  activate 64-bit transfers.  Other-
     wise burst sizes will be  returned in 32-bit mode.

RETURN VALUES
     ddidmasetsbus64() returns:





SunOS 5.11           Last change: 1 Jan 1997                    1






Kernel Functions for Drivers               ddidmasetsbus64(9F)



     DISUCES     Successfully set the SBus to 64-bit mode.


     DIFAILURE     64-bit mode could not be set.


CONTEXT
     ddidmasetsbus64() can be called  from  user,  kernel,  or
     interrupt context.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SBus                        
    


SEE ALSO
     attributes(5),                 ddidmaaddrbindhandle(9F),
     ddidmaallochandle(9F),       ddidmabufbindhandle(9F),
     ddidmaburstsizes(9F), ddidmaattr(9S)

NOTES
     64-bit SBus mode is activated on a per SBus slot  basis.  If
     there  are  multiple  SBus  cards in one slot, they all must
     operate in 64-bit mode or they all must  operate  in  32-bit
     mode.






















SunOS 5.11           Last change: 1 Jan 1997                    2