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 / hwgraph.admin.z / hwgraph.admin
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhwwwwggggrrrraaaapppphhhh....aaaaddddmmmmiiiinnnn((((DDDD3333XXXX))))                                          hhhhwwwwggggrrrraaaapppphhhh....aaaaddddmmmmiiiinnnn((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh_...._aaaa_dddd_mmmm_iiii_nnnn_:::: device_admin_info_get, device_driver_admin_info_get -
  10.      retrieve administrative information for device driver
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////hhhhwwwwggggrrrraaaapppphhhh....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddrrrriiiivvvveeeerrrr....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddddddiiii....hhhh>>>>
  17.  
  18.      cccchhhhaaaarrrr ****
  19.      ddddeeeevvvviiiicccceeee____aaaaddddmmmmiiiinnnn____iiiinnnnffffoooo____ggggeeeetttt(((( vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _d_e_v__v_h_d_l,,,, cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e))));;;;
  20.  
  21.      cccchhhhaaaarrrr ****
  22.      ddddeeeevvvviiiicccceeee____ddddrrrriiiivvvveeeerrrr____aaaaddddmmmmiiiinnnn____iiiinnnnffffoooo____ggggeeeetttt((((cccchhhhaaaarrrr ****_d_r_i_v_e_r__p_r_e_f_i_x,,,, cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e))));;;;
  23.  
  24.    AAAArrrrgggguuuummmmeeeennnnttttssss
  25.      _d_e_v__v_h_d_l
  26.           Vertex handle of a device vertex in the hwgraph.
  27.  
  28.      _i_n_f_o__n_a_m_e
  29.           Character string used as a key to identify desired information.
  30.  
  31.      _d_r_i_v_e_r__p_r_e_f_i_x
  32.           Character string used as device driver's prefix.
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      The _l_b_o_o_t(1) command collects DEVICE_ADMIN and DRIVER_ADMIN directives
  36.      from files in /var/sysgen/system.  These statements associate arbitrary
  37.      character strings with instances of devices or with device drivers.  The
  38.      statement syntax is documented in _s_y_s_t_e_m(4).
  39.  
  40.      The DRIVER_ADMIN directive specifies a driver prefix, a label string, and
  41.      a value string.  _l_b_o_o_t associates the label and value tuple with the
  42.      driver prefix.  The driver retrieves the string by calling
  43.      _d_e_v_i_c_e__d_r_i_v_e_r__a_d_m_i_n__i_n_f_o__g_e_t().
  44.  
  45.      The DEVICE_ADMIN directive specifies a path in the /hw filesystem, a
  46.      label string, and a value string.  _l_b_o_o_t stores all three strings.  When
  47.      a vertex is created in the hwgraph (for example, using
  48.      _h_w_g_r_a_p_h__c_h_a_r__d_e_v_i_c_e__a_d_d(), see _h_w_g_r_a_p_h._d_e_v(D3X)) such that it creates the
  49.      path given in DEVICE_ADMIN, the relevant DEVICE_ADMIN string is retrieved
  50.      and stored in the vertex.  The driver can query for an admin string at
  51.      any time by calling _d_e_v_i_c_e__a_d_m_i_n__i_n_f_o__g_e_t().
  52.  
  53.      In each case the meaning of the retrieved string is established by the
  54.      driver.  These facilities allow a device driver to support arbitrary
  55.      "contracts" with the administrator using a single, simple mechanism.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhwwwwggggrrrraaaapppphhhh....aaaaddddmmmmiiiinnnn((((DDDD3333XXXX))))                                          hhhhwwwwggggrrrraaaapppphhhh....aaaaddddmmmmiiiinnnn((((DDDD3333XXXX))))
  71.  
  72.  
  73.  
  74. DIAGNOSTICS
  75.      These functions return NULL when no appropriate information is found, or
  76.      a pointer to a read-only copy of the information string when one is
  77.      found.
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      lboot(1), system(4), hwgraph.dev(D3X), hwgraph.intro(D4X),
  81.      hwgraph.lblinfo(D3X).
  82.  
  83.  
  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.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.