home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / msgctl.z / msgctl
Encoding:
Text File  |  1998-10-20  |  7.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmssssggggccccttttllll((((2222))))                                                            mmmmssssggggccccttttllll((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_ssss_gggg_cccc_tttt_llll - message control operations
  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_////_iiii_pppp_cccc_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_mmmm_ssss_gggg_...._hhhh_>>>>
  15.  
  16.      _iiii_nnnn_tttt _mmmm_ssss_gggg_cccc_tttt_llll_((((_iiii_nnnn_tttt _mmmm_ssss_qqqq_iiii_dddd_,,,, _iiii_nnnn_tttt _cccc_mmmm_dddd_,,,, _...._...._...._////_**** _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_ssss_qqqq_iiii_dddd______dddd_ssss _****_bbbb_uuuu_ffff _****_////_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _mmmm_ssss_gggg_cccc_tttt_llll provides a variety of message control operations as specified by
  20.      _c_m_d.  The following _c_m_ds are available:
  21.  
  22.      _IIII_PPPP_CCCC______SSSS_TTTT_AAAA_TTTT    Place the current value of each member of the data structure
  23.                  associated with _m_s_q_i_d into the structure pointed to by _b_u_f.
  24.                  The contents of this structure are defined in _iiii_nnnn_tttt_rrrr_oooo(2).
  25.  
  26.      _IIII_PPPP_CCCC______SSSS_EEEE_TTTT     Set the value of the following members of the data structure
  27.                  associated with _m_s_q_i_d to the corresponding value found in the
  28.                  structure pointed to by _b_u_f:
  29.                        _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._uuuu_iiii_dddd
  30.                        _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._gggg_iiii_dddd
  31.                        _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._mmmm_oooo_dddd_eeee _////_**** _oooo_nnnn_llll_yyyy _aaaa_cccc_cccc_eeee_ssss_ssss _pppp_eeee_rrrr_mmmm_iiii_ssss_ssss_iiii_oooo_nnnn _bbbb_iiii_tttt_ssss _****_////
  32.                        _mmmm_ssss_gggg______qqqq_bbbb_yyyy_tttt_eeee_ssss
  33.  
  34.                  This _c_m_d can only be executed by a process that has an
  35.                  effective user ID equal to the value of _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._cccc_uuuu_iiii_dddd or
  36.                  _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._uuuu_iiii_dddd in the data structure associated with _m_s_q_i_d, or
  37.                  by a process that has the super-user privilege.
  38.  
  39.      A process with the super-user privilege can raise the value of
  40.      _mmmm_ssss_gggg______qqqq_bbbb_yyyy_tttt_eeee_ssss.
  41.  
  42.      _IIII_PPPP_CCCC______RRRR_MMMM_IIII_DDDD
  43.           Remove the message queue identifier specified by _m_s_q_i_d from the
  44.           system and destroy the message queue and data structure associated
  45.           with it.  This _c_m_d can only be executed by a process that has an
  46.           effective user ID equal to either that of super user, or to the
  47.           value of _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._cccc_uuuu_iiii_dddd or _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._uuuu_iiii_dddd in the data structure
  48.           associated with _m_s_q_i_d.
  49.  
  50.      _mmmm_ssss_gggg_cccc_tttt_llll fails if one or more of the following are true:
  51.  
  52.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS         _c_m_d is _IIII_PPPP_CCCC______SSSS_TTTT_AAAA_TTTT and operation permission is denied to the
  53.                     calling process [see _iiii_nnnn_tttt_rrrr_oooo(2)].
  54.  
  55.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         _b_u_f points to an illegal address.
  56.  
  57.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         _m_s_q_i_d is not a valid message queue identifier.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmssssggggccccttttllll((((2222))))                                                            mmmmssssggggccccttttllll((((2222))))
  71.  
  72.  
  73.  
  74.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         _c_m_d is not a valid command.
  75.  
  76.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         _c_m_d is _IIII_PPPP_CCCC______SSSS_EEEE_TTTT and _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._uuuu_iiii_dddd or _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._gggg_iiii_dddd is not
  77.                     valid.
  78.  
  79.      _EEEE_OOOO_VVVV_EEEE_RRRR_FFFF_LLLL_OOOO_WWWW      _c_m_d is _IIII_PPPP_CCCC______SSSS_TTTT_AAAA_TTTT and _u_i_d or _g_i_d is too large to be stored
  80.                     in the structure pointed to by _b_u_f.
  81.  
  82.      _EEEE_PPPP_EEEE_RRRR_MMMM          _c_m_d is _IIII_PPPP_CCCC______RRRR_MMMM_IIII_DDDD or _IIII_PPPP_CCCC______SSSS_EEEE_TTTT, the effective user ID of the
  83.                     calling process is not equal to the value of _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._cccc_uuuu_iiii_dddd
  84.                     or _mmmm_ssss_gggg______pppp_eeee_rrrr_mmmm_...._uuuu_iiii_dddd in the data structure associated with
  85.                     _m_s_q_i_d and the process does not have the super-user
  86.                     privilege.
  87.  
  88.      _EEEE_PPPP_EEEE_RRRR_MMMM          _c_m_d is _IIII_PPPP_CCCC______SSSS_EEEE_TTTT, an attempt is being made to increase to
  89.                     the value of _mmmm_ssss_gggg______qqqq_bbbb_yyyy_tttt_eeee_ssss, and the calling process does not
  90.                     have the super-user privilege.
  91.  
  92. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  93.      _iiii_nnnn_tttt_rrrr_oooo(2), _mmmm_ssss_gggg_gggg_eeee_tttt(2), _mmmm_ssss_gggg_oooo_pppp(2).
  94.  
  95. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  96.      Upon successful completion, a value of 0 is returned. Otherwise, a value
  97.      of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  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.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.