seyon.help

功能丰富的串口通讯程序

	      Special  characters are interpreted the same as for
	      transmit.	If the timeout	argument  is  specified,
	      Seyon  will  wait	that  number  of seconds for the
	      string to appear.	If no timeout	is  given,  Seyon
	      defaults to 30 seconds.

	      During  waitfor processing, characters received (up
	      to and including the last character  found  in  the
	      text  or	in the timeout) can be captured to a disk
	      file (if capture on is specified), and/or displayed
	      to the screen (if tty on is specified).

       when [<string-to-expect> <string-to-send>]
	      Sends string-to-send whenever it encounters string-
	      to-expect while waiting in a waitfor command, what-
	      ever   the  number  if  times  string-to-expect  is
	      encountered.

	      This is is useful if the order of prompts	expected
	      is  not  known  before  hand. For example, some BBS
	      systems  (notably	PCBoard)  change   the	prompts

							       19

	      depeding on the time of call, and a complete script
	      for such boards cannot  be  written  using  waitfor
	      only.

	      As  many	number of when commands as desired can be
	      specified. A when command with no arguments  clears
	      all  outstanding	when  commands.	waitfor commands
	      take precedence over when commands if  they  expect
	      the same string.

	      A typical use of this command would be:

		      when "Continue?"	"y^M"
		      when "More?"	   "n^M"
		      waitfor "BBS Command?"
		      when

	      The  above script keeps sending "y^M" to every Con-
	      tinue?" prompt and "n^M" to  every  "More?"  prompt
	      until the the string "BBS Command?" is encountered.
	      The lasy when clears all outstanding when commands.

FILES
       The default Seyon files are startup, phonelist, and proto-
       cols.  These have to be in the current directory,  Seyon's
       default	directory  (~/.seyon),	or the user's home direc-
       tory. The default  script  directory  is	Seyon's  default
       directory. All of these files and directories can be over-
       ridden by  setting  the	appropriate  resources.	See  the
       description  of those resources as well as the description
       of the files above.

SEE ALSO
       xterm(1), resize(1)

COPYRIGHT
       Seyon is Copyright (c) 1992-1993 of  Muhammad  M.  Saggaf.
       Seyon  is  not public domain. Permission is granted to use
       and distribute Seyon freely for any use and to sell it  at
       any  price  without  reference to the copyright owner pro-
       vided that in all above cases Seyon is intact and  is  not
       made  part  of  any program either in whole or in part and
       that this copyright notice is included with Seyon. Permis-
       sion  is	also granted to modify the source as long as the
       modified source is not distributed.

BUGS
       The script command 'set port' is	not  supported	in  this
       release.	If  the  action DialEntries is not the last in a
       compound action stack, actions specified by  the	resource

							       20

       postConnectAction may not work properly.

       If  Seyon  is  hung,  it	can  be  made to exit cleanly by
       killing its main	process  by  signal  15  (SIGTERM)  from
       another	shell.	Seyon's	main process is the one that has
       the lowest PID (Process ID) number.  For	example,  if  ps
       shows:

		1100 p0 S     0:04 seyon -noemulator
		1101 p0 S     0:00 seyon -noemulator
		1102 p0 S     0:38 seyon -noemulator

       Then  ``kill -15 1100'' or ``kill 1100'' would cause Seyon
       clean up and exit gracefully.

AUTHOR
       Muhammad M. Saggaf, [e-mail]. Snail Mail: Muhammad
       Saggaf, Box 9863, Dhahran 31311, SAUDI ARABIA. I apologize
       that I may not be able to respond to all correspondence	I
       receive.

       xcomm 2.2 was written by Eric Coe and Larry Gensch.

ACKNOWLEDGEMENT
       David  Boyce for helpuful suggestions, the Imake file, and
       patches for clean build under gcc -Wall; Joaquim Jorge for
       the  lex/yacc parsing routines contributed by him; and the
       many people who sent me	patches	for  various  platforms:
       Fred  Appleman  (SVR4),	[e-mail] (Ultrix),
       Alain Hebert (SVR3.2),  Peter  Davies  (Sun  Sparc),  Eric
       Schmidt	(Apollo),  David  Sanderson (AIX), Jonathan Bayer
       (Sun), Jeff Johnson (SVR4), Glenn Geers (SVR4-Esix),  Tony
       Vincent-Sun-Vienna  (Solaris),  Bob  Smith  (SunOS 3.x and
       sgtty interface). (pardon me if I forgot to mention  you).
       I'm  also thankful to all the nice people who sent me sug-
       gestions or bug reports.

       The MultiList widget used  in  the  dialing  directory  is
       written	by the Free Widget Foundation. You can get it and
       other FWF widgets by ftp from a.cs.uiuc.edu.

							       21

=======================================

   Seyon Copyright (c) 1992-1993 Muhammad M. Saggaf. Seyon has its
   roots in xcomm 2.2.

=======================================

Help: Gives you this help.

Set: Sets the program parameters. Parameters can also be set in the
    startup file, in the directory file, and in a script file.

Dial: Takes you to the dialing directory. Double click on an item to
    choose it. Clicking once highlights the item(s). Once the dialer
    takes over, you can interrupt the dialing or script execution at
    any time by pressing 'Cancel'.

Transfer: Takes you to the transfer console. You can double-click on
    item to choose it and you will be promted for a file name if the
    protocols needs one. Refer to the FAQ for a description of the
    format of the protocols file.

Shell: Accepts a command for to be passed to the shell. If the command
    starts with '$', stdio will be redirected to the modem. You can
    use this to do file transfer as well.

Misc: Takes to some miscelaneous utilities, you can send a break by
    choosing 'Break' under this button. You can also refresh
    (restart) the terminal process by choosing 'Refresh' from here
    this will not restart the terminal window, just the process).

Hangup: Hangs up the modem.

Exit: Exits Seyon.

=======================================

   The name of the Seyon directory is '~/.seyon'. The startup file is
   'startup'. That of the dialing directory is 'phonelist' and that of
   the protocols file is 'protocols'.  These have to be in the
   current, Seyon, or home directoy. Three examples (startup,
   phonelist, and protocols) are included.

=======================================

   Send success stories and bug reports to [e-mail]. If you
   like Seyon, send me email to that effect. This will give me the
   incentive to continue maintaining it.

-----------------------------------------------------------------------------

		   F R E Q U E N T LY   A X E D   Q U E S T I O N S

-----------------------------------------------------------------------------

	Thanks to Johann Miranda for his help in maintainig this FAQ.

-----------------------------------------------------------------------------

    Warning: Some of the things below are terribly outdated. Tha
    manual page, though, is always up-to-date.

-----------------------------------------------------------------------------

Q: How can I obtain Seyon?

A: Well, the best way is to ftp to one of the following sites:

         sipb.mit.edu:/pub/seyon
         export.lcs.mit.edu:/contrib
         nic.funet.fi
         sunsite.unc.edu

   The *newes* version of Seyon can be found at sipb.mit.edu. Beta
   versions can found at: 

	     sipb.mit.edu:/pub/seyon/new-beta

   and context diffs against previous versions at:

	     sipb.mit.edu:/pub/seyon/new-beta/DIFFS

   You may have to hunt around in other sites to find the most recent
   release.

-----------------------------------------------------------------------------

Q: How do I build and install Seyon?

A: Seyon comes with a file called 1-INSTALL, which basically tells you
   what you need to do to install it. You should also create a
   directory with the name ".seyon" in your home directory. Copy the
   files ``startup'', ``phonelist'' and ``startup'' to this directory
   (the make file will probably do that automatically for you) and
   edit them to your heart's content; or better yet, run Seyon and
   modify these these files from the command center. Once you have
   installed Seyon, you may wish to browse through the man page, it is
   complete and up-to-date.

-----------------------------------------------------------------------------

Q: How do I use Seyon?

   This is easy. After installation, just type "seyon -modems
   <modem-device> &" to invoke Seyon. From the command center you can
   set up your modem parameters, line parameters, scripts, phone
   numbers, transfer protocols, to wit anything you are likely to
   need.  Afterwards, customaize Seyon to your needs by putting the
   appropriate resources in your ~/.Xresources or ~/.Xdefaults file
   (at least to avoid typing the -modems switch every time).

-----------------------------------------------------------------------------

Q: Where can I send bug reports and suggestions? Where can I get more
   information about the development and use of Seyon? Where can I
   participate in general discussions about Seyon? Where can I get the
   most up-to-date announcements about official and test releases?

A: Join the Seyon mailing list. Send a message to

            [e-mail]

   with the following as one of the headers:

            X-Mn-Admin: join Seyon

   That should do it. To get more information about how to use the
   mailing list and send to it, send a message to the above address
   with the single word ``help'' as the subject and the body of the
   message.

-----------------------------------------------------------------------------

Q: Yesterday I compiled Seyon 2.12, however when I tried to run it,
   it gave me "Dial Arborted: Online". So I hangup first, the message
   now is "Line disconnected", then I dialed again, still "online".
   I quit and run kermit immediately and it works fine. This 'Online'
   problem happens even I hard-boot my system and run seyon at once.
   Has anybody have the same experience ? Any help will be appreciated.

A: Seyon is smarter that kermit (well, at least it tries to). Before
   dialing a number, Seyon first checks to see if the modem is already
   on-line. It does so by querying the status of the DCD flag (Data
   Carrier Detect). If DCD is asserted, Seyon concludes that the modem is
   on-line and refuses to dial the number.

   Two resources govern this behavior. The first is hangupBeforeDial. If
   this resource is enabled (set to ``on'') and DCD is asserted, Seyon
   hangs up the line before dialing. The second is ignoreModemDCD. If
   this resource is enabled, Seyon ignores the status of DCD and 1)
   always hangs up befoe dialing if hangupBeforeDial is enabled, and 2)
   proceeds to dial even if DCD is asserted.

   In your case I think that your modem is asserting DCD all the time,
   even if the modem is off-line. When dialing, Seyon finds that DCD is
   asserted and hangs up. However, after hanging up, it finds that DCD is
   still asserted, and since the default for ignoreModemDCD is ``off'',
   it refuses to dial.

   To fix that, you have two options. The first is to tell your modem not
   to assert DCD all the time. The command for that in my modem is
   ``AT&C1'' (AT&C0 does the opposite), but might be different in yours.
   If you don't wish to do that, set the resource ignoreModemDCD to
   ``on''. This way Seyon will ignore DCD and behave just like kermit. To
   set the resource, put the line:

             Seyon.ignoreModemDCD: on

   in your ~/.Xresource file.

   The on-line clock at the top left corner of Seyon's command center
   will tell you whether DCD is asserted (clock running, button light or
   depressed) or not (clock not running, button dark or raised). The
   manual has more details and explanations of the above resources.

-----------------------------------------------------------------------------

Q: I get the messages

>> Warning: could not execute 'seyon-emu'.
>> Warning: falling to 'xterm'.

   when I start Seyon.

A: When Seyon s invoked. It looks first for seyon-emu and uses it as
   the terminal emulator. seyon-emu has to be a link to you favorite
   terminal emulation program (xterm, color xterm, xvt, mterm, Emu,
   cmdtool, ..etc). This allows for more flexibility in choosing the
   terminal emulator. If Seyon doesn't find seyon-emu, it just uses
   xterm as the terminal emulator. This warning is harmless. To get
   rid of it, make seyon-emu a link to xterm.

Q: How do I use the meta (ALT) key with Seyon?

A: If the remote host supports 8-bit-clean communications, you should
   be able to use it automatically (most hosts don't).  Otherwise, you
   can make Seyon send ESC before a character when the meta key is
   pressed with that character.  You can do that in two ways:

   1) Set Meta->ESC translation to ``on'' using one of the following:
      a) the resource metaKeyTranslation 
      b) from the ``Set'' console
      c) in a script: ``set meta_tr on''

   2) if you're using xterm as Seyon's terminal emulator, use

      Seyon.vt100.eightBitInput: off

-----------------------------------------------------------------------------