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 / rmallocmap.z / rmallocmap
Encoding:
Text File  |  1998-10-30  |  4.3 KB  |  66 lines
  1.  
  2.  
  3.  
  4. rrrrmmmmaaaallllllllooooccccmmmmaaaapppp((((DDDD3333))))                                                  rrrrmmmmaaaallllllllooooccccmmmmaaaapppp((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp - allocate and initialize 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.      _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_aaaa_pppp _****_rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp_((((_uuuu_llll_oooo_nnnn_gggg______tttt _m_a_p_s_i_z_e_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _m_a_p_s_i_z_e   Number of entries for the map.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp allocates and initializes a private map array that can be used
  22.      for the allocation of space.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      On success, _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp returns a pointer to the newly allocated map.  On
  26.      failure, a _NNNN_UUUU_LLLL_LLLL pointer is returned.
  27.  
  28. UUUUSSSSAAAAGGGGEEEE
  29.      Although _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp allocates and initializes the map array itself, it
  30.      does not allocate the space that the map will manage.  This space must be
  31.      allocated separately and must be added to the map using _rrrr_mmmm_ffff_rrrr_eeee_eeee(D3) prior
  32.      to attempting to allocate space from the map using _rrrr_mmmm_aaaa_llll_llll_oooo_cccc(D3) or
  33.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt(D3).
  34.  
  35.      The system maintains the map list structure by size and index.  The
  36.      caller places whatever semantics on the units of size are appropriate for
  37.      the type of space being managed.  For example, units may be byte
  38.      addresses, pages of memory, or blocks.
  39.  
  40.      On systems where the _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp function is available, DDI/DKI conforming
  41.      drivers may only use _mmmm_aaaa_pppp structures which have been allocated and
  42.      initialized using _rrrr_mmmm_aaaa_llll_llll_oooo_cccc_mmmm_aaaa_pppp.  Use of _mmmm_aaaa_pppp structures which have been
  43.      obtained by any other means is prohibited on such systems.
  44.  
  45.    LLLLeeeevvvveeeellll
  46.      Initialization, Base or Interrupt.
  47.  
  48.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  49.      Does not sleep.
  50.  
  51.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  52.      across calls to this function.
  53.  
  54. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  55.      _rrrr_mmmm_aaaa_llll_llll_oooo_cccc(D3), _rrrr_mmmm_aaaa_llll_llll_oooo_cccc______wwww_aaaa_iiii_tttt(D3), _rrrr_mmmm_ffff_rrrr_eeee_eeee(D3), _rrrr_mmmm_ffff_rrrr_eeee_eeee_mmmm_aaaa_pppp(D3)
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.