home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / rmalloc_wait.z / rmalloc_wait
Encoding:
Text File  |  1998-10-30  |  4.0 KB  |  66 lines
  1.  
  2.  
  3.  
  4. rrrrmmmmaaaalllllllloooocccc____wwwwaaaaiiiitttt((((DDDD3333))))                                              rrrrmmmmaaaalllllllloooocccc____wwwwaaaaiiiitttt((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt - allocate space from a private space management map
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_aaaa_pppp_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _uuuu_llll_oooo_nnnn_gggg______tttt _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_aaaa_pppp _****_m_p_,,,, _ssss_iiii_zzzz_eeee______tttt _s_i_z_e_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _m_p        Pointer to map to resource map.
  19.  
  20.      _s_i_z_e      Number of units to allocate.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt allocates space from a private map previously allocated
  24.      using _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp(D3).
  25.  
  26.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  27.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt returns the base of the allocated space.
  28.  
  29. UUUUSSSSAAAAGGGGEEEE
  30.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt is identical to _rrrr_mmmm_aaaa_llll_llll_oooo_cccc(D3), except that a call to
  31.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt will sleep (uninterruptible by signals), if necessary, until
  32.      space becomes available.
  33.  
  34.      Space allocated using _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt may be returned to the map using
  35.      _rrrr_mmmm_ffff_rrrr_eeee_eeee(D3).
  36.  
  37.    LLLLeeeevvvveeeellll
  38.      Base only.
  39.  
  40.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  41.      May sleep.
  42.  
  43.      Driver-defined basic locks and read/write locks may not be held across
  44.      calls to this function.
  45.  
  46.      Driver-defined sleep locks may be held across calls to this function, but
  47.      the driver writer must be cautious to avoid deadlock between the process
  48.      holding the lock and trying to acquire the resource and another process
  49.      holding the resource and trying to acquire the lock.
  50.  
  51. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  52.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc(D3), _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp(D3), _rrrr_mmmm_ffff_rrrr_eeee_eeee(D3), _rrrr_mmmm_ffff_rrrr_eeee_eeee_mmmm_aaaa_pppp(D3)
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.