home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / phalloc.z / phalloc
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  66 lines
  1.  
  2.  
  3.  
  4. pppphhhhaaaalllllllloooocccc((((DDDD3333))))                                                        pppphhhhaaaalllllllloooocccc((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_hhhh_aaaa_llll_llll_oooo_cccc - allocate and initialize a pollhead structure
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_pppp_oooo_llll_llll_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_kkkk_mmmm_eeee_mmmm_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _ssss_tttt_rrrr_uuuu_cccc_tttt _pppp_oooo_llll_llll_hhhh_eeee_aaaa_dddd _****_pppp_hhhh_aaaa_llll_llll_oooo_cccc_((((_iiii_nnnn_tttt _f_l_a_g_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _f_l_a_g      Specifies whether the caller is willing to sleep waiting for
  19.                memory.
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _pppp_hhhh_aaaa_llll_llll_oooo_cccc allocates and initializes a _pppp_oooo_llll_llll_hhhh_eeee_aaaa_dddd structure for use by non-
  23.      STREAMS character drivers that wish to support polling.  If _f_l_a_g is set
  24.      to _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP, the caller will sleep if necessary until sufficient memory
  25.      is available.  If _f_l_a_g is set to _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP, the caller will not sleep,
  26.      but _pppp_hhhh_aaaa_llll_llll_oooo_cccc will return _NNNN_UUUU_LLLL_LLLL if sufficient memory is not immediately
  27.      available.
  28.  
  29.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  30.      On success, _pppp_hhhh_aaaa_llll_llll_oooo_cccc returns a pointer to the newly allocated _pppp_oooo_llll_llll_hhhh_eeee_aaaa_dddd
  31.      structure.  If _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP is specified and sufficient memory is not
  32.      immediately available, _pppp_hhhh_aaaa_llll_llll_oooo_cccc returns a _NNNN_UUUU_LLLL_LLLL pointer.
  33.  
  34. UUUUSSSSAAAAGGGGEEEE
  35.      On systems where the _pppp_hhhh_aaaa_llll_llll_oooo_cccc function is available, DDI/DKI conforming
  36.      drivers should only use _pppp_oooo_llll_llll_hhhh_eeee_aaaa_dddd structures which have been allocated and
  37.      initialized using _pppp_hhhh_aaaa_llll_llll_oooo_cccc.  Use of _pppp_oooo_llll_llll_hhhh_eeee_aaaa_dddd structures which have been
  38.      obtained by any other means is prohibited on such systems.
  39.  
  40.    LLLLeeeevvvveeeellll
  41.      Base only if _f_l_a_g is set to _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP.
  42.  
  43.      Initialization, Base or Interrupt if _f_l_a_g is set to _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP.
  44.  
  45.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  46.      May sleep if flag is set to _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP.
  47.  
  48.      Driver-defined basic locks and read/write locks may be held across calls
  49.      to this function if _f_l_a_g is _KKKK_MMMM______NNNN_OOOO_SSSS_LLLL_EEEE_EEEE_PPPP but may not be held if _f_l_a_g is
  50.      _KKKK_MMMM______SSSS_LLLL_EEEE_EEEE_PPPP.
  51.  
  52.      Driver-defined sleep locks may be held across calls to this function
  53.      regardless of the value of _f_l_a_g.
  54.  
  55. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  56.      _pppp_oooo_llll_llll(D2), _pppp_hhhh_ffff_rrrr_eeee_eeee(D3)
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.