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.
 
 
 
 
 
 

391 lines
8.5 KiB

  1. .\" -*- nroff -*-
  2. .TH MODEMU2k 1 "June 2020" "Versão 0.0.6"
  3. .\"
  4. .\"
  5. .SH NOME
  6. .\"
  7. modemu2k \- conexão TCP discada
  8. .\"
  9. .\"
  10. .SH SINOPSE
  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 DESCRIÇÃO
  18. .\"
  19. .B Modemu2k
  20. é um cliente TELNET com uma interface de usuário do tipo modem.
  21. Ele pode redirecionar sua E/S por meio de um
  22. .BR pty (4)
  23. de modo que um programa de comunicação possa lidar com o pty como um tty com um modem real.
  24. .PP
  25. .B Modemu2k
  26. tem dois modos principais: um modo de comando e modo online.
  27. Quando invocado,
  28. .B modemu2k
  29. está no modo de comando, esperando por entrada de comandos AT.
  30. Digitar um comando D ou O irá colocá-lo no modo online, no qual \" <===
  31. .B modemu2k
  32. comunica-se com um host remoto.
  33. O encerramento da conexão ou a entrada de um comando de escape o retorna para o modo de comando.
  34. .\"
  35. .\"
  36. .SH OPÇÕES
  37. .\" ===== -c =====
  38. .TP
  39. .BI -c " comm_prog"
  40. Invoca um programa de comunicação \fIcomm_prog\fP.
  41. .B Modemu2k
  42. invoca-o passando ao /bin/sh uma opção `-c \fIcomm_prog\fP'.
  43. Portanto, quaisquer comandos
  44. .BR sh (1)
  45. podem ser especificados.
  46. A string \fIcomm_prog\fP pode incluir um `%s',
  47. que será substituído pelo
  48. nome do dispositivo slave após a remoção do "/dev/" inicial.
  49. .RS
  50. Exemplo:
  51. .RS
  52. modemu2k -c "xc -l %s"
  53. .RE
  54. .RE
  55. .\" ===== -d =====
  56. .TP
  57. .BI -d " pty_master"
  58. Abre um arquivo \fIpty_master\fP e se comunica através dele.
  59. Uma pipe nomeada pode ser uma
  60. .I pty_master
  61. bem como um dispositivo pty master pois o
  62. .B modemu2k
  63. não faz o ioctl do \fIpty_master\fP.
  64. .\" ===== -e =====
  65. .TP
  66. .BI -e " atcmds"
  67. Executa uma série de comandos AT \fIatcmds\fP inicialmente.
  68. .I Atcmds
  69. precisam ter um prefixo `AT' ou `at'.
  70. Comandos D e O no \fIatcmds\fP são ignorados.
  71. .\" ===== -h =====
  72. .TP
  73. .B -h
  74. Imprime um resumo de uso.
  75. .\" ===== -s =====
  76. .TP
  77. .B -s
  78. Imprime as duas últimas letras de um nome de dispositivo.
  79. O dispositivo é um pty master pelo qual o
  80. .B modemu2k
  81. se comunica.
  82. Portanto, quando o
  83. .B modemu2k
  84. imprime `p8',
  85. o programa de comunicação precisa abrir o /dev/tty\fIp8\fP.
  86. .\" ==========
  87. .PP
  88. Nota: As opções -c, -d, -s e - são exclusivas entre si.
  89. Se duas ou mais entre tais opções forem especificadas,
  90. somente a última será considerada.
  91. .\"
  92. .\"
  93. .SH MODO DE COMANDO
  94. .\"
  95. O modo de comando espera linhas no seguinte formato:
  96. .IP ""
  97. [\fIgarbage\fP]\fIat\fP[\fIsp\fP][\fIcmd\fP[\fIsp\fP]]...\fIcr\fP
  98. .PP
  99. onde
  100. .I at
  101. é um `AT' ou `at',
  102. .I sp
  103. é espaços,
  104. .I cr
  105. é um caractere de retorno de carro [carriage return] (register S3),
  106. .I garbage
  107. é uma string que não inclui \fIat\fP.
  108. Se uma linha começa com `#', tal linha é ignorada.
  109. Estão listados abaixo os
  110. .IR cmd s
  111. disponíveis.
  112. Eles não diferenciam maiúsculas de minúsculas, exceto por alguns argumentos usados literalmente.
  113. Um (*) marca as configurações padrão.
  114. .\" ===== D =====
  115. .TP
  116. .BI D str
  117. Comando de discagem.
  118. Abre uma conexão ao \fIhost\fP.
  119. Se \fIport\fP é especificado,
  120. .B modemu2k
  121. tentará se conectar com tal porta em vez da porta TELNET padrão,
  122. e
  123. não inicia a negociação da opção TELNET.
  124. Os seguintes formatos estão disponíveis para \fIstr\fP:
  125. .RS
  126. .TP
  127. \fIhost\fP [\fIport\fP]
  128. \fIHost\fP é um endereço da Internet na notação de números e pontos.
  129. O opcional \fIport\fP é um número de porta.
  130. .TP
  131. "\fIhost\fP [\fIport\fP]["]
  132. \fIHost\fP é um endereço da Internet ou nome de host.
  133. O opcional \fIport\fP é um número de porta ou nome de serviço.
  134. A aspa dupla de fechamento pode ser omitida caso nenhum comando vier posteriormente.
  135. .PP
  136. .I Str
  137. pode ser prefixado por `T', `P', `\fIdigit\fPW' e/ou `\fIdigit\fP,'.
  138. Os prefixos são simplesmente ignorados.
  139. .br
  140. Exemplo:
  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. Sem operação.
  151. .\" ===== F =====
  152. .TP
  153. .B F1
  154. Sem operação.
  155. .\" ===== H =====
  156. .TP
  157. .BR H [ 0 ]
  158. Encerra a sessão TELNET atual.
  159. .\" ===== I =====
  160. .TP
  161. .BI I n
  162. Imprime várias informações.
  163. .RS
  164. .IP I4
  165. Configurações atuais
  166. .IP I5
  167. Configurações que foram `&W'
  168. .IP I6
  169. Estados de opção do TELNET
  170. .IP I7
  171. Versão do
  172. .B Modemu2k
  173. .RE
  174. .\" ===== O =====
  175. .TP
  176. .BR O [ 0 ]
  177. Retorna para o modo online.
  178. .\" ===== P =====
  179. .TP
  180. .B P
  181. Sem operação.
  182. .\" ===== Q =====
  183. .TP
  184. .BR Q [ 0 ]
  185. Sem operação.
  186. .TP
  187. .B T
  188. Sem operação.
  189. .\" ===== V =====
  190. .TP
  191. .B V1
  192. Sem operação.
  193. .\" ===== X =====
  194. .TP
  195. .BR X [ 0 ]
  196. Sem operação.
  197. .\" ===== Sn=m =====
  198. .TP
  199. .BI S n = m
  200. Define o S-register S\fIn\fP para \fIm\fP.
  201. É permitido um número entre 0 e 255 para o \fIm\fP.
  202. .\" ===== Sn? =====
  203. .TP
  204. .BI S n ?
  205. Imprime um valor S\fIn\fP do S-register.
  206. .\" ===== Z =====
  207. .TP
  208. .B Z
  209. Encerra a sessão TELNET atual, e restaura as configurações que foram `&W'.
  210. .\" ===== &W =====
  211. .TP
  212. .B &W
  213. Salva as configurações atuais.
  214. As configurações salvas serão perdidas com o encerramento do processo
  215. pois elas não são armazenadas nem na NV-RAM nem em arquivos.
  216. .\" ===== %B =====
  217. .TP
  218. .BI %B n = m
  219. Controla a opção binária do TELNET.
  220. São valores válidos para \fIn\fP:
  221. .RS
  222. .RS
  223. .IP 0
  224. Controla a opção local (do modemu2k)
  225. .IP 1
  226. Controla a opção remota (do servidor TELNET)
  227. .RE
  228. .PP
  229. São valores válidos para \fIm\fP:
  230. .RS
  231. .IP 0
  232. Solicita modo de transmissão não-binária (*)
  233. .IP 1
  234. Solicita o modo de transmissão binária (8-bits)
  235. .TP
  236. .I above+2
  237. Desconecta se a solicitação for recusada
  238. .RE
  239. .PP
  240. Exemplo:
  241. .RS
  242. .IP AT%B1=1
  243. Solicitação do modo binário na direção remoto-para-modemu2k
  244. .IP AT%B0=3%B1=3
  245. Solicitação do modo binário
  246. para ambas as direções (remoto-para-modemu2k e modemu2k-para-remoto).
  247. Sem uso na conexão em modo não-binário (usando o protocolo xfer de arquivo ou similar)
  248. .RE
  249. .RE
  250. .\" ===== %D =====
  251. .TP
  252. .BI %D n
  253. Controla o cancelamento de discagem.
  254. .RS
  255. .IP %D0
  256. Um pressionamento de tecla cancela a discagem (*)
  257. .IP %D1
  258. Pressionamentos de tecla não cancelam a discagem
  259. .RE
  260. .\" ===== %L =====
  261. .TP
  262. .BI %L n
  263. Controla o modo de linha.
  264. .RS
  265. .IP %L0
  266. Solicita o modo de um caractere por vez (*)
  267. .IP %L1
  268. Solicita o modo de uma linha por vez (modo de linha antigo).
  269. Os caracteres de entrada são armazenados em buffer e não são enviados até que um caractere CR seja inserido.
  270. .RE
  271. .\" ===== %Q =====
  272. .TP
  273. .B %Q
  274. Sai do
  275. .BR modemu2k .
  276. .\" ===== %R =====
  277. .TP
  278. .BI %R n
  279. Controla o modo bruto.
  280. .RS
  281. .IP %R0
  282. Modo normal (*)
  283. .IP %R1
  284. Modo bruto.
  285. .B Modemu2k
  286. transmite todos os octetos como recebidos.
  287. Aplicado para ambas as direções (remoto-para-modemu2k e modemu2k-para-remoto).
  288. Substitui as configurações %B e %L.
  289. .RE
  290. .\" ===== %T =====
  291. .TP
  292. .BI %T str
  293. Controla a opção do tipo de terminal TELNET.
  294. .RS
  295. .IP %T0
  296. Rejeita a opção do tipo de terminal
  297. .IP %T1
  298. O mesmo que %T="$\fBTERM\fP"
  299. (o valor \fBTERM\fP do ambiente é utilizado) (*)
  300. .IP %T="\fIterm\fP["]
  301. Envia \fIterm\fP como o tipo do terminal se o remoto solicitar.
  302. A aspa dupla de fechamento pode ser omitida caso nenhum comando vier posteriormente.
  303. .RE
  304. .\" ===== %V =====
  305. .TP
  306. .BI %V n
  307. Controla o nível de detalhamento da saída (verbose).
  308. %V0 (*) é o mais silencioso, e adicionar os seguintes valores para \fIn\fP permite que o
  309. .B modemu2k
  310. imprima mais informação para o stderr.
  311. .RS
  312. .IP +1
  313. Imprime informações diversas para compensar a indicação ATX0 menos descritiva
  314. .IP +2
  315. Imprime a negociação da opção TELNET
  316. .RE
  317. .\"
  318. .\"
  319. .SH MODO ONLINE
  320. .\"
  321. .B Modemu2k
  322. reconhece apenas o seguinte comando quando está no modo online.
  323. .\" ===== +++ =====
  324. .TP
  325. .IB "wait " +++ " wait"
  326. Retorna para o modo de comando.
  327. O `+++' deve ser inserido dentro do tempo de guarda.
  328. .I Wait
  329. é um período de tempo maior que o tempo de guarda
  330. sem pressionar nenhuma tecla.
  331. Consulte também as descrições do register S2 e S12.
  332. .\"
  333. .\"
  334. .SH S REGISTERS
  335. .\"
  336. Apenas registers significativos são listados aqui.
  337. Os valores padrão estão entre parênteses.
  338. .TP
  339. .B S2
  340. Código do caractere de escape. (43 = `+')
  341. .TP
  342. .B S3
  343. Código do caractere de retorno de carro [carriage return].
  344. (13)
  345. .TP
  346. .B S4
  347. Código do caractere de quebra de linha [line feed].
  348. (10)
  349. .TP
  350. .B S5
  351. Código do caractere de retrocesso [backspace].
  352. (8)
  353. .TP
  354. .B S7
  355. Tempo limite de tentativa de conexão em segundos.
  356. (20)
  357. .TP
  358. .B S12
  359. Tempo de guarda da sequência de escape em quinquagésimos de um segundo.
  360. (50)
  361. .\"
  362. .\"
  363. .SH VARIÁVEIS DE AMBIENTE
  364. .\"
  365. .TP
  366. .B MODEMU2k
  367. Inicialmente avaliada como comandos AT
  368. (antes que o argumento da opção -e seja avaliado).
  369. Obrigatório possuir um prefixo `AT' ou `at'.
  370. .TP
  371. .B TERM
  372. Consulte a descrição do comando %T1.
  373. .\"
  374. .\"
  375. .SH AUTOR
  376. Andy Alt (andy400-dev@yahoo.com)
  377. .\"
  378. .\"
  379. .SH CONSULTE TAMBÉM
  380. telnet(1),
  381. .I O manual do seu modem favorito
  382. .\"
  383. .\"
  384. .SH BUGS
  385. .\"
  386. Não há capacidade de restrição de discagem ou de lista negra.
  387. Dessa forma, o uso do
  388. .B modemu2k
  389. talvez seja contrário a lei em alguns países. B)