You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

390 lines
8.2 KiB

  1. .\" -*- nroff -*-
  2. .TH MODEMU2k 1 "June 2020" "Versione 0.0.6"
  3. .\"
  4. .\"
  5. .SH NOME
  6. .\"
  7. modemu2k \- connessione TCP dialup
  8. .\"
  9. .\"
  10. .SH SINOSSI
  11. .\"
  12. .B modemu2k
  13. [\fB-c \fIcomm_prog\fR] [\fB-d \fIpty_master\fR] [\fB-e \fIatcmds\fR]
  14. [\fB-h\fR] [\fB-s\fR] [\fB-\fR]
  15. .\"
  16. .\"
  17. .SH DESCRIZIONE
  18. .\"
  19. .B Modemu2k
  20. è un client TELNET con una interfaccia utente del tipo modem.
  21. Può redirezionare i suoi I/O attraverso un
  22. .BR pty (4)
  23. in modo che un programma comm possa gestire i pty come un tty con un modem reale.
  24. .PP
  25. .B Modemu2k
  26. Ha due modalità pricipali: una modalità di comando e una modalità online.
  27. Quando invocato,
  28. .B modemu2k
  29. è nella modalità di comando, in attesa di un comando AT in ingresso.
  30. Inserendo un comando D oppure O lo collocherà nella modalità online, in cui \" <===
  31. .B modemu2k
  32. comunica con un host remoto.
  33. La chiusura della connessione o un comando di ritorna alla modalità di commando.
  34. .\"
  35. .\"
  36. .SH OPZIONI
  37. .\" ===== -c =====
  38. .TP
  39. .BI -c " comm_prog"
  40. Invoca un programma comm \fIcomm_prog\fP.
  41. .B Modemu2k
  42. lo invoca passando a /bin/sh un'opzione `-c \fIcomm_prog\fP'.
  43. Dunque, qualsiasi comando
  44. .BR sh (1)
  45. può essere specificato.
  46. La stringa \fIcomm_prog\fP può includere un `%s',
  47. che sarà rimpiazzato con
  48. il device name del dispositivo slave dopo aver rimosso il "/dev/" iniziale.
  49. .RS
  50. Esempio:
  51. .RS
  52. modemu2k -c "xc -l %s"
  53. .RE
  54. .RE
  55. .\" ===== -d =====
  56. .TP
  57. .BI -d " pty_master"
  58. Apre un file \fIpty_master\fP e comunica tramite di esso.
  59. Un pipe nominato può essere sia un
  60. .I pty_master
  61. che un dispositivo pty master dato che
  62. .B modemu2k
  63. non esegue ioctl su \fIpty_master\fP.
  64. .\" ===== -e =====
  65. .TP
  66. .BI -e " atcmds"
  67. Esegue una series di comandi AT \fIatcmds\fP inizialmente.
  68. .I Atcmds
  69. deve avere un prefisso `AT' o `at'.
  70. i comandi D e O sono ignorati in \fIatcmds\fP.
  71. .\" ===== -h =====
  72. .TP
  73. .B -h
  74. Stampa un riassunto dell'utilizzo.
  75. .\" ===== -s =====
  76. .TP
  77. .B -s
  78. Stampa le ultime due lettere del nome di un dispositivo.
  79. Il dispositivo è un master pty attraverso il quale
  80. .B modemu2k
  81. parla.
  82. Quindi, quando
  83. .B modemu2k
  84. stampa `p8',
  85. il programma comm deve aprire /dev/tty\fIp8\fP.
  86. .\" ==========
  87. .PP
  88. Nota: le opzioni -c, -d, -s e - sono esclusive.
  89. Se più di una opzione è specificata,
  90. solo l'ultima è effettiva.
  91. .\"
  92. .\"
  93. .SH MODALITA' DI COMANDO
  94. .\"
  95. La modalità di comando prevede una riga nel seguente formato:
  96. .IP ""
  97. [\fIgarbage\fP]\fIat\fP[\fIsp\fP][\fIcmd\fP[\fIsp\fP]]...\fIcr\fP
  98. .PP
  99. dove
  100. .I at
  101. è un `AT' o `at',
  102. .I sp
  103. sono spazi,
  104. .I cr
  105. è il carattere di ritorno a capo (registro S3),
  106. .I garbage
  107. è una stringa che non include \fIat\fP.
  108. Se un `#' precede una riga, questa è ignorata.
  109. Di seguito sono elencati i
  110. .IR cmd s
  111. disponibili.
  112. Sono tutti case in-sensitive ad eccezione di alcuni argomenti usati letteralmente.
  113. Un (*) marca le impostazioni predefinite.
  114. .\" ===== D =====
  115. .TP
  116. .BI D str
  117. Comando di composizione.
  118. Apre una connessione a \fIhost\fP.
  119. Se \fIport\fP è specificato,
  120. .B modemu2k
  121. prova a connettersi a quella porta nvece che alla porta predefinita per TELNET,
  122. e
  123. non inizia la negoziazione di operazioni TELNET.
  124. I formati seguenti sono disponibili per \fIstr\fP:
  125. .RS
  126. .TP
  127. \fIhost\fP [\fIport\fP]
  128. \fIHost\fP è un indirizzo internet in notazione numeri-e-punti.
  129. Opzionale \fIport\fP è un numero di porta.
  130. .TP
  131. "\fIhost\fP [\fIport\fP]["]
  132. \fIHost\fP è un indirizzo internet o un nome host.
  133. Opzionale \fIport\fP è un numero di porta o il nome di un servizio.
  134. La virgoletta doppia di chiusura può essere omessa se non segue nessun comando.
  135. .PP
  136. .I Str
  137. può essere preceduto da `T', `P', `\fIdigit\fPW' e/o `\fIdigit\fP,'.
  138. I prefissi sono semplicemente ignorati.
  139. .br
  140. Esempio:
  141. .RS
  142. ATDT0W127.0.0.1
  143. .br
  144. ATDP"foo.bar.jp daytime
  145. .RE
  146. .RE
  147. .\" ===== E =====
  148. .TP
  149. .B E1
  150. Nessuna operazione.
  151. .\" ===== F =====
  152. .TP
  153. .B F1
  154. Nessuna operazione.
  155. .\" ===== H =====
  156. .TP
  157. .BR H [ 0 ]
  158. Chiude la sessione TELNET attuale.
  159. .\" ===== I =====
  160. .TP
  161. .BI I n
  162. Stampa varie informazioni.
  163. .RS
  164. .IP I4
  165. Impostazioni attuali
  166. .IP I5
  167. Configurazioni che sono state `&W'
  168. .IP I6
  169. stato delle opzioni TELNET
  170. .IP I7
  171. Versione di
  172. .B Modemu2k
  173. .RE
  174. .\" ===== O =====
  175. .TP
  176. .BR O [ 0 ]
  177. Ritorna alla modalità online.
  178. .\" ===== P =====
  179. .TP
  180. .B P
  181. Nessuna operazione.
  182. .\" ===== Q =====
  183. .TP
  184. .BR Q [ 0 ]
  185. Nessuna operazione.
  186. .TP
  187. .B T
  188. Nessuna operazione.
  189. .\" ===== V =====
  190. .TP
  191. .B V1
  192. Nessuna operazione.
  193. .\" ===== X =====
  194. .TP
  195. .BR X [ 0 ]
  196. Nessuna operazione.
  197. .\" ===== Sn=m =====
  198. .TP
  199. .BI S n = m
  200. Imposta il S-register S\fIn\fP a \fIm\fP.
  201. E' consentio un numero da 0 a 255 per \fIm\fP.
  202. .\" ===== Sn? =====
  203. .TP
  204. .BI S n ?
  205. Stampa il valore di un S-register S\fIn\fP.
  206. .\" ===== Z =====
  207. .TP
  208. .B Z
  209. Chiudi la sessione TELNET attuale, e ripristina le impostazioni che sono state `&W'.
  210. .\" ===== &W =====
  211. .TP
  212. .B &W
  213. Salva le impostazioni attuali.
  214. Le impostazioni salvate andranno perse alla fine del processo
  215. perchè non sono memorizzate nella NV-RAM o in files.
  216. .\" ===== %B =====
  217. .TP
  218. .BI %B n = m
  219. Controlla le opzioni binarie TELNET.
  220. I valori validi per \fIn\fP sono:
  221. .RS
  222. .RS
  223. .IP 0
  224. Controlla le opzioni locali (modemu2k)
  225. .IP 1
  226. Controlla le opzioni remote (server TELNET)
  227. .RE
  228. .PP
  229. I vaori validi per \fIm\fP sono:
  230. .RS
  231. .IP 0
  232. Richiedi la modalità di trasmissione non-binaria (*)
  233. .IP 1
  234. Richiedi la modalità di trasmissione binaria (8-bit)
  235. .TP
  236. .I above+2
  237. Disconnectti se la richiesta è rifiutata
  238. .RE
  239. .PP
  240. Esempio:
  241. .RS
  242. .IP AT%B1=1
  243. Richiesta della modalità binaria in direzione remoto-a-modemu2k
  244. .IP AT%B0=3%B1=3
  245. Richiesta modalità binaria
  246. sia in direzione remoto-a-modemu2k che modemu2k-a-remoto.
  247. Inutile connettersi in modalità non binaria (utilizzndo il protocollo file xfer o qualcosa del genere)
  248. .RE
  249. .RE
  250. .\" ===== %D =====
  251. .TP
  252. .BI %D n
  253. Annullamento della composizione.
  254. .RS
  255. .IP %D0
  256. Premere un tasto annulla la composizione (*)
  257. .IP %D1
  258. Premere un tasto non annulla la composizione
  259. .RE
  260. .\" ===== %L =====
  261. .TP
  262. .BI %L n
  263. Controllo modalità linea.
  264. .RS
  265. .IP %L0
  266. Richiedi modalità a un carattere alla volta (*)
  267. .IP %L1
  268. Richiedi modalità a una linea per volta (vecchia modalità linea).
  269. I caratteri di input sono inseriti in un buffer e non sono inviati finchè non si inserisce un carattere CR.
  270. .RE
  271. .\" ===== %Q =====
  272. .TP
  273. .B %Q
  274. Esci
  275. .BR modemu2k .
  276. .\" ===== %R =====
  277. .TP
  278. .BI %R n
  279. Controllo modalità raw.
  280. .RS
  281. .IP %R0
  282. Modalità normale (*)
  283. .IP %R1
  284. Modalità raw.
  285. .B Modemu2k
  286. trasmette gli octet come ricevuti.
  287. Applicato sia in direzione remoto-a-modemu2k che modemu2k-a-remoto..
  288. Ignora impostazioni %B e %L.
  289. .RE
  290. .\" ===== %T =====
  291. .TP
  292. .BI %T str
  293. Controlla operazioni TELNET di tipo da terminale.
  294. .RS
  295. .IP %T0
  296. Rifiuta l'opzione da terminal
  297. .IP %T1
  298. Lo stesso di %T="$\fBTERM\fP"
  299. (E' usato il valore \fBTERM\fP d'ambiente) (*)
  300. .IP %T="\fIterm\fP["]
  301. Invia \fIterm\fP come da terminal se presenti richieste remote.
  302. La virgoletta doppia di chiusura può essere omessa se non segue nessun comando.
  303. .RE
  304. .\" ===== %V =====
  305. .TP
  306. .BI %V n
  307. Controllo livello verbose.
  308. %V0 (*) è il più silenzioso e, aggiungendo valori successivi a \fIn\fP permette a
  309. .B modemu2k
  310. di stampare più informazioni su stderr.
  311. .RS
  312. .IP +1
  313. Stampa informazioni miste per compensare le indicazioni ATX0 meno descrittive
  314. .IP +2
  315. Stampa la negoziazione di opzioni TELNET
  316. .RE
  317. .\"
  318. .\"
  319. .SH MODALTA' ONLINE
  320. .\"
  321. .B Modemu2k
  322. riconosce solo i seguenti comandi quando è in modalità online.
  323. .\" ===== +++ =====
  324. .TP
  325. .IB "wait " +++ " wait"
  326. Rirorna alla modalità di comando.
  327. I `+++' devono essere inseriti entro il tempo di guardia.
  328. .I Wait
  329. èun periodo di tempo maggiore del tempo di guardia
  330. senza premere alcun tasto.
  331. Vedi anche la descrizione dei registri S2 e S12.
  332. .\"
  333. .\"
  334. .SH REGISTRI S
  335. .\"
  336. Sono elencati solo i registri significativi.
  337. I valori tra parentesi sono i predefiniti
  338. .TP
  339. .B S2
  340. Codice del carattere di escape. (43 = `+')
  341. .TP
  342. .B S3
  343. Codice del ritorno a capo.
  344. (13)
  345. .TP
  346. .B S4
  347. Codice di avanzamento di linea [line feed].
  348. (10)
  349. .TP
  350. .B S5
  351. Codice del carattere backspace.
  352. (8)
  353. .TP
  354. .B S7
  355. Limite di tempo per i tentativi di connessione in secondi.
  356. (20)
  357. .TP
  358. .B S12
  359. Tempo di guardia della sequenza diescape in 50esimi si secondo.
  360. (50)
  361. .\"
  362. .\"
  363. .SH VARIABILI D'AMBIENTE
  364. .\"
  365. .TP
  366. .B MODEMU2k
  367. Inizialmente valutati come comandi AT
  368. (prima che l'argomento dell'opzione -e sia valutato).
  369. Deve essere preceduto da un `AT' o `at'.
  370. .TP
  371. .B TERM
  372. Consulta la descrizione del comando %T1.
  373. .\"
  374. .\"
  375. .SH AUTORE
  376. Andy Alt (andy400-dev@yahoo.com)
  377. .\"
  378. .\"
  379. .SH VEDI ANCHE
  380. telnet(1),
  381. .I Your favorite modem's manual
  382. .\"
  383. .\"
  384. .SH BUG
  385. .\"
  386. Nessuna restrizione sulla composizione, o blacklisting.
  387. Quindi usare
  388. .B modemu2k
  389. potrebbe essere illegale in alcuni paesi. B)