.\" -*- nroff -*-.TH MODEMU 1 "1 April 1995" "Version 0.0".\".\".SH NAME.\"modemu \- dialup TCP connecting.\".\".SH SYNOPSIS.\".B modemu[\fB-c \fIcomm_prog\fR] [\fB-d \fIpty_master\fR] [\fB-e \fIatcmds\fR][\fB-h\fR] [\fB-s\fR] [\fB-\fR].\".\".SH DESCRIPTION.\".B Modemuis a TELNET client with a modem-like user interface.It can redirect its I/O via a.BR pty (4)so that a comm program can handle the pty as a tty with a real modem..PP.B Modemuhas two major modes: a command mode and online mode.When invoked,.B modemuis in the command mode, waiting for AT commands input.Entering a D or O command will put into the online mode, in which \" <===.B modemucommunicate with a remote host.Connection closing or a escape command input returns to the command mode..\".\".SH OPTIONS.\" ===== -c =====.TP.BI -c " comm_prog"Invoke a comm program \fIcomm_prog\fP..B Modemuinvokes it by passing /bin/sh an option `-c \fIcomm_prog\fP'.Therefore, any.BR sh (1)commands can be specified.The string \fIcomm_prog\fP can include a `%s',which will be replaced with the last two letters of a device name.The device is a pty slave device which the comm program must open..RSExample:.RSmodemu -c "xc -l tty%s".RE.RE.\" ===== -d =====.TP.BI -d " pty_master"Open a file \fIpty_master\fP and talk through it.A named pipe can be a.I pty_masteras well as a pty master device because.B modemudoesn't ioctl a \fIpty_master\fP..\" ===== -e =====.TP.BI -e " atcmds"Execute a series of AT commands \fIatcmds\fP initially..I Atcmdsmust have an `AT' or `at' prefix.D and O commands in \fIatcmds\fP are ignored..\" ===== -h =====.TP.B -hPrint a usage summary..\" ===== -s =====.TP.B -sPrint the last two letters of a device name.The device is a pty master device which.B modemutalks through.Therefore, when.B modemuprints `p8',comm program must open /dev/tty\fIp8\fP..\" ===== - =====.TP.B `-'.B Modemutalks through the standard input/output. (Default).\" ==========.PPNote: -c, -d, -s and - options are exclusive each other.If two or more of the options are specified,only the last one is effective..\".\".SH COMMAND MODE.\"Command mode expects lines in the following format:.IP ""[\fIgarbage\fP]\fIat\fP[\fIsp\fP][\fIcmd\fP[\fIsp\fP]]...\fIcr\fP.PPwhere.I atis an `AT' or `at',.I spis spaces,.I cris a carriage return character (register S3),.I garbageis a string includes no \fIat\fP.If a `#' prefixes a line, the line is ignored.Available.IR cmd sare listed below.They are all case in-sensitive except for some literally used arguments.A (*) marks default settings..\" ===== D =====.TP.BI D strDialing command.Open a connection to \fIhost\fP.If \fIport\fP is specified,.B modemuattempts to connect with the port instead of the default TELNET port,anddoesn't initiate TELNET option negotiation.The following formats are available for \fIstr\fP:.RS.TP\fIhost\fP[:\fIport\fP]\fIHost\fP is an Internet address in numbers-and-dots notation.Optional \fIport\fP is a port number..TP"\fIhost\fP[:\fIport\fP]["]\fIHost\fP is an Internet address or host name.Optional \fIport\fP is a port number or service name.The closing double quote can be omitted if no command follows..PP.I Strcan be prefixed with `T', `P', `\fIdigit\fPW' and/or `\fIdigit\fP,'.The prefixes are simply ignored..brExample:.RSATDT0W127.0.0.1.brATDP"foo.bar.jp:daytime.RE.RE.\" ===== E =====.TP.B E1No operation..\" ===== F =====.TP.B F1No operation..\" ===== H =====.TP.BR H [ 0 ]Close the current TELNET session..\" ===== I =====.TP.BI I nPrint various information..RS.IP I4Current settings.IP I5`&W'ed settings.IP I6TELNET option states.IP I7.B Modemuversion.RE.\" ===== O =====.TP.BR O [ 0 ]Return to online mode..\" ===== P =====.TP.B PNo operation..\" ===== Q =====.TP.BR Q [ 0 ]No operation..TP.B TNo operation..\" ===== V =====.TP.B V1No operation..\" ===== X =====.TP.BR X [ 0 ]No operation..\" ===== Sn=m =====.TP.BI S n = mSet S-register S\fIn\fP to \fIm\fP.A number from 0-255 is allowed for \fIm\fP..\" ===== Sn? =====.TP.BI S n ?Print an S-register S\fIn\fP's value..\" ===== Z =====.TP.B ZClose the current TELNET session, and restore `&W'ed settings..\" ===== &W =====.TP.B &WSave current settings.The saved settings will be lost with the end of the processbecause they are not stored into NV-RAM nor files..\" ===== %B =====.TP.BI %B n = mControl TELNET binary option.Valid values for \fIn\fP are:.RS.RS.IP 0Control the local (modemu) option.IP 1Control the remote (TELNET server) option.RE.PPValid values for \fIm\fP are:.RS.IP 0Request non-binary transmission mode (*).IP 1Request binary transmission (8bit through) mode.TP.I above+2Disconnect if the request is refused.RE.PPExample:.RS.IP AT%B1=1Requesting binary mode in remote-to-modemu direction.IP AT%B0=3%B1=3Requesting binary modein both remote-to-modemu and modemu-to-remote direction.No use connecting in non-binary mode (using file xfer protocol or something).RE.RE.\" ===== %D =====.TP.BI %D nControl dial-canceling..RS.IP %D0A keypress cancels dialing (*).IP %D1Keypresses don't cancel dialing.RE.\" ===== %L =====.TP.BI %L nControl line-mode..RS.IP %L0Request character-at-a-time mode (*).IP %L1Request line-at-a-time mode (old line-mode).Input characters are buffered and not sent until a CR character is entered..RE.\" ===== %Q =====.TP.B %QQuit.BR modemu ..\" ===== %R =====.TP.BI %R nControl raw-mode..RS.IP %R0Normal mode (*).IP %R1Raw mode..B Modemutransmits every octet as received.Applied to both remote-to-modemu and modemu-to-remote direction.Override %B and %L settings..RE.\" ===== %T =====.TP.BI %T strControl TELNET terminal-type option..RS.IP %T0Refuse terminal-type option.IP %T1Same as %T="$\fBTERM\fP"(\fBTERM\fP environment value is used) (*).IP %T="\fIterm\fP["]Send \fIterm\fP as the terminal-type if remote requests.The closing double quote can be omitted if no command follows..RE.\" ===== %V =====.TP.BI %V nControl verbose level.%V0 (*) is the quietest, and adding following values to \fIn\fP lets.B modemuprint more information to stderr..RS.IP +1Print misc info to make up for less descriptive ATX0 indication.IP +2Print TELNET option negotioation.RE.\".\".SH ONLINE MODE.\".B Modemurecognizes only the following command when in online mode..\" ===== +++ =====.TP.IB "wait " +++ " wait"Escape to command mode.The `+++' must be input within the guard time..I Waitis a period of time longer than the guard timewithout hitting any key.See also S2 and S12 register descriptions..\".\".SH S REGISTERS.\"Only meaningful registers are listed here.Values in braces are default ones..TP.B S2Escape character code. (43 = `+').TP.B S3Carriage return character code.(13).TP.B S4Line feed character code.(10).TP.B S5Backspace character code.(8).TP.B S7Connecting attempt time limit in seconds.(20).TP.B S12Escape sequence guard time in 50ths of a second. (50).\".\".SH ENVIRONMENT VARIABLES.\".TP.B MODEMUInitially evaluated as AT commands(before -e option argument is evaluated).Must have an `AT' or `at' prefix..TP.B TERMSee %T1 command description..\".\".SH AUTHORToru Egashira (egashira@nwk.CL.nec.co.jp).\".\".SH SEE ALSOtelnet(1),.I Your favorite modem's manual.\".\".SH BUGS.\"No dial-resriction, or blacklisting, capability.So using.B modemumaybe unlawful in some countries. B)