modemu.1
上传用户:tianjinjs
上传日期:2007-01-05
资源大小:309k
文件大小:7k
源码类别:

Modem编程

开发平台:

Unix_Linux

  1. ." -*- nroff -*-
  2. .TH MODEMU 1 "1 April 1995" "Version 0.0"
  3. ."
  4. ."
  5. .SH NAME
  6. ."
  7. modemu - dialup TCP connecting
  8. ."
  9. ."
  10. .SH SYNOPSIS
  11. ."
  12. .B modemu
  13. [fB-c fIcomm_progfR] [fB-d fIpty_masterfR] [fB-e fIatcmdsfR]
  14. [fB-hfR] [fB-sfR] [fB-fR]
  15. ."
  16. ."
  17. .SH DESCRIPTION
  18. ."
  19. .B Modemu
  20. is a TELNET client with a modem-like user interface.
  21. It can redirect its I/O via a
  22. .BR pty (4)
  23. so that a comm program can handle the pty as a tty with a real modem.
  24. .PP
  25. .B Modemu
  26. has two major modes: a command mode and online mode.
  27. When invoked,
  28. .B modemu
  29. is in the command mode, waiting for AT commands input.
  30. Entering a D or O command will put into the online mode, in which " <===
  31. .B modemu
  32. communicate with a remote host.
  33. Connection closing or a escape command input returns to the command mode.
  34. ."
  35. ."
  36. .SH OPTIONS
  37. ." ===== -c =====
  38. .TP
  39. .BI -c " comm_prog"
  40. Invoke a comm program fIcomm_progfP.
  41. .B Modemu
  42. invokes it by passing /bin/sh an option `-c fIcomm_progfP'.
  43. Therefore, any
  44. .BR sh (1)
  45. commands can be specified.
  46. The string fIcomm_progfP can include a `%s',
  47. which will be replaced with the last two letters of a device name.
  48. The device is a pty slave device which the comm program must open.
  49. .RS
  50. Example:
  51. .RS
  52. modemu -c "xc -l tty%s"
  53. .RE
  54. .RE
  55. ." ===== -d =====
  56. .TP
  57. .BI -d " pty_master"
  58. Open a file fIpty_masterfP and talk through it.
  59. A named pipe can be a
  60. .I pty_master
  61. as well as a pty master device because
  62. .B modemu
  63. doesn't ioctl a fIpty_masterfP.
  64. ." ===== -e =====
  65. .TP
  66. .BI -e " atcmds"
  67. Execute a series of AT commands fIatcmdsfP initially.
  68. .I Atcmds
  69. must have an `AT' or `at' prefix.
  70. D and O commands in fIatcmdsfP are ignored.
  71. ." ===== -h =====
  72. .TP
  73. .B -h
  74. Print a usage summary.
  75. ." ===== -s =====
  76. .TP
  77. .B -s
  78. Print the last two letters of a device name.
  79. The device is a pty master device which
  80. .B modemu
  81. talks through.
  82. Therefore, when
  83. .B modemu
  84. prints `p8',
  85. comm program must open /dev/ttyfIp8fP.
  86. ." ===== - =====
  87. .TP
  88. .B `-'
  89. .B Modemu
  90. talks through the standard input/output. (Default)
  91. ." ==========
  92. .PP
  93. Note: -c, -d, -s and - options are exclusive each other.
  94. If two or more of the options are specified,
  95. only the last one is effective.
  96. ."
  97. ."
  98. .SH COMMAND MODE
  99. ."
  100. Command mode expects lines in the following format:
  101. .IP ""
  102. [fIgarbagefP]fIatfP[fIspfP][fIcmdfP[fIspfP]]...fIcrfP
  103. .PP
  104. where
  105. .I at
  106. is an `AT' or `at',
  107. .I sp
  108. is spaces,
  109. .I cr
  110. is a carriage return character (register S3),
  111. .I garbage
  112. is a string includes no fIatfP.
  113. If a `#' prefixes a line, the line is ignored.
  114. Available
  115. .IR cmd s
  116. are listed below.
  117. They are all case in-sensitive except for some literally used arguments.
  118. A (*) marks default settings.
  119. ." ===== D =====
  120. .TP
  121. .BI D str
  122. Dialing command.
  123. Open a connection to fIhostfP.
  124. If fIportfP is specified,
  125. .B modemu
  126. attempts to connect with the port instead of the default TELNET port,
  127. and
  128. doesn't initiate TELNET option negotiation.
  129. The following formats are available for fIstrfP:
  130. .RS
  131. .TP
  132. fIhostfP[:fIportfP]
  133. fIHostfP is an Internet address in numbers-and-dots notation.
  134. Optional fIportfP is a port number.
  135. .TP
  136. "fIhostfP[:fIportfP]["]
  137. fIHostfP is an Internet address or host name.
  138. Optional fIportfP is a port number or service name.
  139. The closing double quote can be omitted if no command follows.
  140. .PP
  141. .I Str
  142. can be prefixed with `T', `P', `fIdigitfPW' and/or `fIdigitfP,'.
  143. The prefixes are simply ignored.
  144. .br
  145. Example:
  146. .RS
  147. ATDT0W127.0.0.1
  148. .br
  149. ATDP"foo.bar.jp:daytime
  150. .RE
  151. .RE
  152. ." ===== E =====
  153. .TP
  154. .B E1
  155. No operation.
  156. ." ===== F =====
  157. .TP
  158. .B F1
  159. No operation.
  160. ." ===== H =====
  161. .TP
  162. .BR H [ 0 ]
  163. Close the current TELNET session.
  164. ." ===== I =====
  165. .TP
  166. .BI I n
  167. Print various information.
  168. .RS
  169. .IP I4
  170. Current settings
  171. .IP I5
  172. `&W'ed settings
  173. .IP I6
  174. TELNET option states
  175. .IP I7
  176. .B Modemu
  177. version
  178. .RE
  179. ." ===== O =====
  180. .TP
  181. .BR O [ 0 ]
  182. Return to online mode.
  183. ." ===== P =====
  184. .TP
  185. .B P
  186. No operation.
  187. ." ===== Q =====
  188. .TP
  189. .BR Q [ 0 ]
  190. No operation.
  191. .TP
  192. .B T
  193. No operation.
  194. ." ===== V =====
  195. .TP
  196. .B V1
  197. No operation.
  198. ." ===== X =====
  199. .TP
  200. .BR X [ 0 ]
  201. No operation.
  202. ." ===== Sn=m =====
  203. .TP
  204. .BI S n = m
  205. Set S-register SfInfP to fImfP.
  206. A number from 0-255 is allowed for fImfP.
  207. ." ===== Sn? =====
  208. .TP
  209. .BI S n ?
  210. Print an S-register SfInfP's value.
  211. ." ===== Z =====
  212. .TP
  213. .B Z
  214. Close the current TELNET session, and restore `&W'ed settings.
  215. ." ===== &W =====
  216. .TP
  217. .B &W
  218. Save current settings.
  219. The saved settings will be lost with the end of the process
  220. because they are not stored into NV-RAM nor files.
  221. ." ===== %B =====
  222. .TP
  223. .BI %B n = m
  224. Control TELNET binary option.
  225. Valid values for fInfP are:
  226. .RS
  227. .RS
  228. .IP 0
  229. Control the local (modemu) option
  230. .IP 1
  231. Control the remote (TELNET server) option
  232. .RE
  233. .PP
  234. Valid values for fImfP are:
  235. .RS
  236. .IP 0
  237. Request non-binary transmission mode (*)
  238. .IP 1
  239. Request binary transmission (8bit through) mode
  240. .TP
  241. .I above+2
  242. Disconnect if the request is refused
  243. .RE
  244. .PP
  245. Example:
  246. .RS
  247. .IP AT%B1=1
  248. Requesting binary mode in remote-to-modemu direction
  249. .IP AT%B0=3%B1=3
  250. Requesting binary mode
  251. in both remote-to-modemu and modemu-to-remote direction.
  252. No use connecting in non-binary mode (using file xfer protocol or something)
  253. .RE
  254. .RE
  255. ." ===== %D =====
  256. .TP
  257. .BI %D n
  258. Control dial-canceling.
  259. .RS
  260. .IP %D0
  261. A keypress cancels dialing (*)
  262. .IP %D1
  263. Keypresses don't cancel dialing
  264. .RE
  265. ." ===== %L =====
  266. .TP
  267. .BI %L n
  268. Control line-mode.
  269. .RS
  270. .IP %L0
  271. Request character-at-a-time mode (*)
  272. .IP %L1
  273. Request line-at-a-time mode (old line-mode).
  274. Input characters are buffered and not sent until a CR character is entered.
  275. .RE
  276. ." ===== %Q =====
  277. .TP
  278. .B %Q
  279. Quit
  280. .BR modemu .
  281. ." ===== %R =====
  282. .TP
  283. .BI %R n
  284. Control raw-mode.
  285. .RS
  286. .IP %R0
  287. Normal mode (*)
  288. .IP %R1
  289. Raw mode.
  290. .B Modemu
  291. transmits every octet as received.
  292. Applied to both remote-to-modemu and modemu-to-remote direction.
  293. Override %B and %L settings.
  294. .RE
  295. ." ===== %T =====
  296. .TP
  297. .BI %T str
  298. Control TELNET terminal-type option.
  299. .RS
  300. .IP %T0
  301. Refuse terminal-type option
  302. .IP %T1
  303. Same as %T="$fBTERMfP"
  304. (fBTERMfP environment value is used) (*)
  305. .IP %T="fItermfP["]
  306. Send fItermfP as the terminal-type if remote requests.
  307. The closing double quote can be omitted if no command follows.
  308. .RE
  309. ." ===== %V =====
  310. .TP
  311. .BI %V n
  312. Control verbose level.
  313. %V0 (*) is the quietest, and adding following values to fInfP lets
  314. .B modemu
  315. print more information to stderr.
  316. .RS
  317. .IP +1
  318. Print misc info to make up for less descriptive ATX0 indication
  319. .IP +2
  320. Print TELNET option negotioation
  321. .RE
  322. ."
  323. ."
  324. .SH ONLINE MODE
  325. ."
  326. .B Modemu
  327. recognizes only the following command when in online mode.
  328. ." ===== +++ =====
  329. .TP
  330. .IB "wait " +++ " wait"
  331. Escape to command mode.
  332. The `+++' must be input within the guard time.
  333. .I Wait
  334. is a period of time longer than the guard time
  335. without hitting any key.
  336. See also S2 and S12 register descriptions.
  337. ."
  338. ."
  339. .SH S REGISTERS
  340. ."
  341. Only meaningful registers are listed here.
  342. Values in braces are default ones.
  343. .TP
  344. .B S2
  345. Escape character code. (43 = `+')
  346. .TP
  347. .B S3
  348. Carriage return character code.
  349. (13)
  350. .TP
  351. .B S4
  352. Line feed character code.
  353. (10)
  354. .TP
  355. .B S5
  356. Backspace character code.
  357. (8)
  358. .TP
  359. .B S7
  360. Connecting attempt time limit in seconds.
  361. (20)
  362. .TP
  363. .B S12
  364. Escape sequence guard time in 50ths of a second. 
  365. (50)
  366. ."
  367. ."
  368. .SH ENVIRONMENT VARIABLES
  369. ."
  370. .TP
  371. .B MODEMU
  372. Initially evaluated as AT commands
  373. (before -e option argument is evaluated).
  374. Must have an `AT' or `at' prefix.
  375. .TP
  376. .B TERM
  377. See %T1 command description.
  378. ."
  379. ."
  380. .SH AUTHOR
  381. Toru Egashira (egashira@nwk.CL.nec.co.jp)
  382. ."
  383. ."
  384. .SH SEE ALSO
  385. telnet(1),
  386. .I Your favorite modem's manual
  387. ."
  388. ."
  389. .SH BUGS
  390. ."
  391. No dial-resriction, or blacklisting, capability.
  392. So using
  393. .B modemu
  394. maybe unlawful in some countries. B)