home *** CD-ROM | disk | FTP | other *** search
/ Software USA 4 #11 / Software USA Volume 4.11.iso / mac / Educational / mac06 / usr / man / man3.1 / fopen.3
Encoding:
Text File  |  1998-02-15  |  3.3 KB  |  140 lines  |  [TEXT/ttxt]
  1. .TH fopen 1 "by hns@computer.org" "standard library"
  2. .SH NAME
  3. fopen \- retrieve and display full subtrees
  4.  
  5. .SH SYNOPSIS
  6. #include <stdio.h>
  7. FILE *fopen(char *name)
  8.  
  9. .SH DESCRIPTION
  10. These programs can be called directly at the shell prompt to send SNMP
  11. requests to agents for 'barefooted' network management.
  12.  
  13. .SH OPTIONS
  14. .SS -a agent:port:protocol
  15. Specifies the agent to access.
  16. Its value defaults to the contents of the environment variable AGENT
  17. if defined
  18. or 'localhost:snmp:udp'.
  19.  
  20. .SS -c community
  21. Sets the community. 
  22. The default is 'public'.
  23.  
  24. .SS -w timeout
  25. Defines a timeout to wait for a response.
  26. The timeout is specified in seconds. Fractions with a resolution of 1 ms are permitted.
  27. The default is 5 seconds.
  28.  
  29. .SS -r retries
  30. Defines the number of retries for the walk operation until the client gives up.
  31. The default is 3.
  32.  
  33. .SS -g generic
  34. Defines the generic trap number (between 0 and 6).
  35. The default is 0.
  36.  
  37. .SS -s specific
  38. Defines the specific trap number.
  39. The default is 0.
  40.  
  41. .SS -T timestamp
  42. Defines the timestamp of the trap (in TIMETICKS).
  43. The default is 0.
  44.  
  45. .SS -d
  46. Dump all SNMP protocol data units sent and received on stderr.
  47.  
  48. .SS -u
  49. Dump all UDP service data units sent and received on stderr.
  50.  
  51. .SS -o
  52. Print object identifier of responses.
  53.  
  54. .SS -v
  55. Print value of responses.
  56.  
  57. .SS -t
  58. Print type of responses.
  59. If neither -o, -v, nor -t is specified, -otv is assumed.
  60.  
  61. .SS enterprise
  62. Specifies the enterprise OBJECT IDENTIFIER within a TRAP PDU.
  63.  
  64. .SS agent
  65. Specifies the agent address within a TRAP PDU.
  66.  
  67. .SS objid
  68. Specifies the object identifier to be accessed.
  69. For snmpwalk, this identifies the root of the subtree.
  70. For
  71. snmptable it specifies the TABLE_ENTRY node or the parent node of
  72. a group of non-tabular elements. Otherwise, strange formatting
  73. may occur.
  74.  
  75. .SS -u url
  76. may be used to specify the agent and the object identifier in a 
  77. single argument. The rules are as follows: The protocol must be 'snmp',
  78.  the host can be specified to override the host already 
  79. defined by an earlier -a or -u option and the object identifier 
  80. is separated by a slash (/). The request is sent to the last 
  81. agent specified.
  82.  
  83. .SS type
  84. Specifies the type of the value to be sent in a SET request or TRAP.
  85. Permitted types are (case insensitive):
  86. .br
  87. null, integer, gauge, counter, timeticks, ipaddr, octstr, objid.
  88.  
  89. .SS value
  90. Specifies the value to be sent in a SET request or TRAP.
  91. If the type is null, no value field is expected.
  92.  
  93. .SH EXAMPLES
  94.  
  95. snmpget -a localhost:snmp:udp 1.3.6.1.2.1.1.4
  96. .br
  97. snmpset -a localhost:snmp:udp 1.3.6.1.2.1.1.4.0 octstr "The new system"
  98. .br
  99. AGENT=myhost:snmp:udp; export AGENT
  100. .br
  101. snmpset -c set-community 1.3.6.1.4.1.860.1.1 integer 123
  102. .br
  103. snmpnext ''
  104. .br
  105. snmpwalk -r 5 1.3.6.1.4.1.860
  106. .br
  107. snmpwalk 
  108. .br
  109. snmptable 1.3.6.1.2.1.2.2.1
  110. .br
  111. snmptable 1.3.6.1.2.1.1
  112. .br
  113. snmptable -a localhost:snmp:udp -ov 1.3.6.1.2.1.3.1.1
  114. .br
  115. snmptable -ov -u snmp://localhost/1.3.6.1.2.1.3.1.1
  116. .br
  117. snmptrap -w 0 -g 1 -a manager:162:udp 1.3.6.1.4.1.860 localhost
  118. .br
  119. snmpwalk -u snmp://myhost/1.3.6.1.2.1.3.1.1
  120. .br
  121. snmpwalk -u snmp:1.3.6.1.2.1.3.1.1
  122.  
  123. .SH ENVIRONMENT
  124. AGENT    may be set to override the default of the -a option
  125.  
  126. .SH SEE ALSO
  127. SNMPt(3SNMPt).
  128.  
  129. .SH BUGS
  130. There is always one more bug (Murphy).
  131.  
  132. .SH AUTHOR
  133. H. Nikolaus Schaller
  134. .br
  135. Lehrstuhl fuer Datenverarbeitung
  136. .br
  137. TU-Muenchen
  138. .br
  139. hns@ldv.e-technik.tu-muenchen.de
  140.