home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / fattach.z / fattach
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  132 lines
  1.  
  2.  
  3.  
  4. ffffaaaattttttttaaaacccchhhh((((3333CCCC))))                                                        ffffaaaattttttttaaaacccchhhh((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh - attach a STREAMS-based file descriptor to an object in the
  10.      filesystem name space
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_uuuu_nnnn_iiii_ssss_tttt_dddd_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh_((((_iiii_nnnn_tttt _ffff_iiii_llll_dddd_eeee_ssss_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_pppp_aaaa_tttt_hhhh_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh routine attaches a STREAMS-based file descriptor to an object
  18.      in the filesystem name space, effectively associating a name with _f_i_l_d_e_s.
  19.      _f_i_l_d_e_s must be a valid open file descriptor representing a STREAMS file.
  20.      _p_a_t_h is a pathname of an existing object, and the effective user ID of
  21.      the calling process must be the owner of the file and have write
  22.      permissions, or the calling process must have appropriate privilege
  23.      (_PPPP______OOOO_WWWW_NNNN_EEEE_RRRR).  All subsequent operations on _p_a_t_h will operate on the STREAMS
  24.      file until the STREAMS file is detached from the node.  _f_i_l_d_e_s can be
  25.      attached to more than one _p_a_t_h; that is, a stream can have several names
  26.      associated with it.
  27.  
  28.      The attributes of the named stream (see _ssss_tttt_aaaa_tttt(2)), are initialized as
  29.      follows:  the permissions, user ID, group ID, and times are set to those
  30.      of _p_a_t_h, the number of links is set to 1, and the size and device
  31.      identifier are set to those of the streams device associated with _f_i_l_d_e_s.
  32.      If any attributes of the named stream are subsequently changed (for
  33.      example, _cccc_hhhh_mmmm_oooo_dddd(2)), the attributes of the underlying object are not
  34.      affected.
  35.  
  36. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  37.      If successful, _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh returns 0; otherwise it returns -1 and sets _eeee_rrrr_rrrr_nnnn_oooo
  38.      to indicate an error.
  39.  
  40. EEEERRRRRRRROOOORRRRSSSS
  41.      Under the following conditions, the function _ffff_aaaa_tttt_tttt_aaaa_cccc_hhhh fails and sets _eeee_rrrr_rrrr_nnnn_oooo
  42.      to:
  43.  
  44.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS       Search permission is denied on a component of the path
  45.                   prefix.
  46.  
  47.      _EEEE_AAAA_CCCC_CCCC_EEEE_SSSS       The user is the owner of the filenamed by _p_a_t_h but does not
  48.                   have write permissions on _p_a_t_h or _f_i_l_d_e_s is locked.
  49.  
  50.      _EEEE_BBBB_AAAA_DDDD_FFFF        _f_i_l_d_e_s is not a valid open file descriptor.
  51.  
  52.      _EEEE_NNNN_OOOO_EEEE_NNNN_TTTT       _p_a_t_h does not exist.
  53.  
  54.      _EEEE_NNNN_OOOO_TTTT_DDDD_IIII_RRRR      A component of a path prefix is not a directory.
  55.  
  56.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL       _f_i_l_d_e_s does not represent a STREAMS file.
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ffffaaaattttttttaaaacccchhhh((((3333CCCC))))                                                        ffffaaaattttttttaaaacccchhhh((((3333CCCC))))
  70.  
  71.  
  72.  
  73.      _EEEE_PPPP_EEEE_RRRR_MMMM        The effective user ID of the calling process is not the
  74.                   owner of the filenamed by _p_a_t_h.
  75.  
  76.      _EEEE_BBBB_UUUU_SSSS_YYYY        _p_a_t_h is currently a mount point or has a STREAMS file
  77.                   descriptor attached it.
  78.  
  79.      _EEEE_NNNN_AAAA_MMMM_EEEE_TTTT_OOOO_OOOO_LLLL_OOOO_NNNN_GGGG The size of _p_a_t_h exceeds _{{{{_PPPP_AAAA_TTTT_HHHH______MMMM_AAAA_XXXX_}}}}, or the component of a
  80.                   pathname is longer than _{{{{_NNNN_AAAA_MMMM_EEEE______MMMM_AAAA_XXXX_}}}} while _{{{{______PPPP_OOOO_SSSS_IIII_XXXX______NNNN_OOOO______TTTT_RRRR_UUUU_NNNN_CCCC_}}}}
  81.                   is in effect.
  82.  
  83.      _EEEE_LLLL_OOOO_OOOO_PPPP        Too many symbolic links were encountered in translating
  84.                   _p_a_t_h.
  85.  
  86.      _EEEE_RRRR_EEEE_MMMM_OOOO_TTTT_EEEE      _p_a_t_h is a file in a remotely mounted directory.
  87.  
  88. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.      fdetach(1M), fdetach(3C), isastream(3C), streamio(7)
  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.