home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 400-499 / ff473.lzh / CNewsSrc / cnews_src.lzh / man / error.man < prev    next >
Text File  |  1991-01-05  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. ERROR(3)               C LIBRARY FUNCTIONS               ERROR(3)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      error, warning - print error messages
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      eeeerrrrrrrroooorrrr((((ssss1111,,,, ssss2222))))
  13.      cccchhhhaaaarrrr ****ssss1111;;;;
  14.      cccchhhhaaaarrrr ****ssss2222;;;;
  15.  
  16.      wwwwaaaarrrrnnnniiiinnnngggg((((ssss1111,,,, ssss2222))))
  17.      cccchhhhaaaarrrr ****ssss1111;;;;
  18.      cccchhhhaaaarrrr ****ssss2222;;;;
  19.  
  20.      eeeexxxxtttteeeerrrrnnnn cccchhhhaaaarrrr ****pppprrrrooooggggnnnnaaaammmmeeee;;;;
  21.      eeeexxxxtttteeeerrrrnnnn iiiinnnntttt eeeerrrrrrrrnnnnoooo;;;;
  22.  
  23.      pppprrrrooooggggnnnnaaaammmmeeee ==== aaaarrrrggggvvvv[[[[0000]]]];;;;
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      _W_a_r_n_i_n_g prints an error message,  with  suitable  embellish-
  27.      ments,  and  clears  _e_r_r_n_o.   _E_r_r_o_r  does  likewise and then
  28.      exits.  The _s_1 argument should be  a  _p_r_i_n_t_f  format  string
  29.      (without  a trailing newline), with _s_2 available as an argu-
  30.      ment.
  31.  
  32.      If there is an environment variable  CCCCMMMMDDDDNNNNAAAAMMMMEEEE  with  non-null
  33.      value,  its contents are printed first, followed by a colon.
  34.      Following this, any non-null value of _p_r_o_g_n_a_m_e  is  printed,
  35.      followed by a colon and a space.  Following this, _f_p_r_i_n_t_f(3)
  36.      is invoked with _s_1 as the format string and _s_2 as the  argu-
  37.      ment.   If  the value of _e_r_r_n_o is within the normal range, a
  38.      standard elaborating message is printed (see _i_n_t_r_o(2)).
  39.  
  40.      CCCCMMMMDDDDNNNNAAAAMMMMEEEE should be set by shellfiles that expect  subordinate
  41.      programs  to  issue  error  message in the shellfile's name.
  42.      _P_r_o_g_n_a_m_e should be set by all programs; _a_r_g_v[_0] is usually a
  43.      suitable  thing  to set it to.  _E_r_r_n_o is set by system calls
  44.      and various other routines, although its use is not  univer-
  45.      sal;  note  that  it is not reset by successful system calls
  46.      following an unsuccessful one.
  47.  
  48. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  49.      intro(2), intro(3), printf(3), exit(2), getopt(3)
  50.  
  51. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  52.      _E_r_r_o_r's exit status is 1.
  53.  
  54. HHHHIIIISSSSTTTTOOOORRRRYYYY
  55.      Local products, modelled on the _e_r_r_o_r in Kernighan&Pike.
  56.  
  57. BBBBUUUUGGGGSSSS
  58.      Be nice if they could  take  a  full  _p_r_i_n_t_f-style  argument
  59.      list.
  60.  
  61.  
  62.  
  63. Sun Microsystems       Last change: local                       1
  64.  
  65.  
  66.  
  67.