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 / rmvb.z / rmvb
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  132 lines
  1.  
  2.  
  3.  
  4. rrrrmmmmvvvvbbbb((((DDDD3333))))                                                              rrrrmmmmvvvvbbbb((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_mmmm_vvvv_bbbb - remove a message block from a message
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _mmmm_bbbb_llll_kkkk______tttt _****_rrrr_mmmm_vvvv_bbbb_((((_mmmm_bbbb_llll_kkkk______tttt _****_m_p_,,,, _mmmm_bbbb_llll_kkkk______tttt _****_b_p_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _m_p        Pointer to the message from which a message block is to be
  18.                removed.
  19.  
  20.      _b_p        Pointer to the message block to be removed.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      _rrrr_mmmm_vvvv_bbbb removes the message block specified by _b_p from the message specified
  24.      _m_p and returns a pointer to the altered message.
  25.  
  26.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  27.      On success, a pointer to the message (minus the removed block) is
  28.      returned.  If _b_p was the only block in the message before _rrrr_mmmm_vvvv_bbbb was
  29.      called, _NNNN_UUUU_LLLL_LLLL is returned.  If the designated message block (_b_p) was not
  30.      in the message, -1 is returned.
  31.  
  32. UUUUSSSSAAAAGGGGEEEE
  33.      The message block is not freed, merely removed from the message.  It is
  34.      the caller's responsibility to free the message block.
  35.  
  36.    LLLLeeeevvvveeeellll
  37.      Base or Interrupt.
  38.  
  39.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  40.      Does not sleep.
  41.  
  42.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  43.      across calls to this function.
  44.  
  45.    EEEExxxxaaaammmmpppplllleeeessss
  46.      This routine removes all zero-length _MMMM______DDDD_AAAA_TTTT_AAAA message blocks from the given
  47.      message.  For each message block in the message, we save the next message
  48.      block (line 9).  If the current message block is of type _MMMM______DDDD_AAAA_TTTT_AAAA and has
  49.      no data in its buffer (lines 10-11), then we remove the message block
  50.      from the message (line 12) and free it (line 13).  In either case, we
  51.      continue with the next message block (line 15), until we have checked
  52.      every message block in the message.
  53.  
  54.       _1111  _vvvv_oooo_iiii_dddd
  55.       _2222  _xxxx_xxxx_cccc_llll_eeee_aaaa_nnnn_((((_mmmm_pppp_))))
  56.       _3333    _mmmm_bbbb_llll_kkkk______tttt _****_mmmm_pppp_;;;;
  57.       _4444  _{{{{
  58.       _5555    _mmmm_bbbb_llll_kkkk______tttt _****_tttt_mmmm_pppp_;;;;
  59.       _6666    _mmmm_bbbb_llll_kkkk______tttt _****_nnnn_mmmm_pppp_;;;;
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. rrrrmmmmvvvvbbbb((((DDDD3333))))                                                              rrrrmmmmvvvvbbbb((((DDDD3333))))
  70.  
  71.  
  72.  
  73.       _7777    _tttt_mmmm_pppp _==== _mmmm_pppp_;;;;
  74.       _8888    _wwww_hhhh_iiii_llll_eeee _((((_tttt_mmmm_pppp_)))) _{{{{
  75.       _9999        _nnnn_mmmm_pppp _==== _tttt_mmmm_pppp_----_>>>>_bbbb______nnnn_eeee_xxxx_tttt_;;;;
  76.      _1111_0000        _iiii_ffff _((((_((((_tttt_mmmm_pppp_----_>>>>_bbbb______dddd_aaaa_tttt_aaaa_pppp_----_>>>>_dddd_bbbb______tttt_yyyy_pppp_eeee _====_==== _MMMM______DDDD_AAAA_TTTT_AAAA_)))) _&&&&_&&&&
  77.      _1111_1111           _((((_tttt_mmmm_pppp_----_>>>>_bbbb______rrrr_pppp_tttt_rrrr _====_==== _tttt_mmmm_pppp_----_>>>>_bbbb______wwww_pppp_tttt_rrrr_))))_)))) _{{{{
  78.      _1111_2222            _mmmm_pppp _==== _rrrr_mmmm_vvvv_bbbb_((((_mmmm_pppp_,,,, _tttt_mmmm_pppp_))))_;;;;
  79.      _1111_3333            _ffff_rrrr_eeee_eeee_bbbb_((((_tttt_mmmm_pppp_))))_;;;;
  80.      _1111_4444        _}}}}
  81.      _1111_5555        _tttt_mmmm_pppp _==== _nnnn_mmmm_pppp_;;;;
  82.      _1111_6666    _}}}}
  83.      _1111_7777  _}}}}
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.