seyon.help

功能丰富的串口通讯程序

NAME
       Seyon - X11 Telecommunications Package.

SYNOPSIS
       seyon  [-option	...]  [-toolkit_option	...]  [-- -emula-
       tor_option ...]

DESCRIPTION
       Seyon is a complete full-featured telecommunications pack-
       age for the X Window System. Some of its features are:

	      * Dialing directory that supports an unlimited num-
	      ber of entries. The directory is fully mouse-driven
	      and  features  call progress monitoring, dial time-
	      out, automatic redial,  multi-number  dialing,  and
	      circular	redial	queue.	Each  item in the dialing
	      directory can be configured with its own baud rate,
	      bit  mask,  and script file.  The dialing directory
	      uses a plain-text phone book  that  can  be  edited
	      from withen Seyon. Seyon also supports manual dial-
	      ing.

	      * Terminal emulation window  supporting  DEC  VT02,
	      Tektronix	4014, and ANSI. Seyon delegates its ter-
	      minal emulation to xterm, so all the familiar xterm
	      functions	such as the scroll-back buffer, cut-and-
	      paste utility, and visual bell are availabe through
	      Seyon's terminal emulation window. Using xterm also
	      means that Seyon has a more complete  emulation  of
	      VT102 than other any Unix or DOS telecommunications
	      program. Other terminal emulation programs can also
	      be  used	with  Seyon  to suit the user's need; for
	      example, color xterm can be used to provide  emula-
	      tion  for color ANSI (popular on many BBS systems),
	      and xvt can be used if memory is a bit tight.

	      * Script language to automate tedious tasks such as
	      logging  into  remote  hosts. Seyon's script inter-
	      preter uses plain-text files and has a syntax simi-
	      lar  to  that  of sh, with a few extra addtions. It
	      supports many familiar statements	such  as  condi-
	      tional  branching	by  if-else and looping by goto.
	      Scripts may be assigned to  items	in  the  dialing
	      directory	for  automatic execution after a connec-
	      tion is made.

	      * Unlimited  number  of  slots  for  external  file
	      transfer protocols.  Protocols are activated from a
	      mouse-driven transfer console that  uses	a  plain-
	      text file, editable from withen Seyon, for protocol
	      configuration. Seyon prompts the user for filenames

								1

	      only  if	the chosen protocol requires filenames or
	      if the transfer operation is an upload,  for  which
	      Seyon  also  accepts  wildcards.	Multiple download
	      directories can  be  specified  for  the	different
	      transfer slots.

	      *	Support  for Zmodem auto-download. Seyon detects
	      incoming Zmodem signature and  automatically  acti-
	      vates  a	user-specified zmodem protocol to receive
	      incoming files. Zmodem transfers can thus	be  com-
	      pletely automatic and require no user intervention.

	      *	Translation  modes.  Seyon  can  perfrom  useful
	      trasnlations  on	the  user's  input. From example,
	      Seyon can translate backspace to delete (useful  on
	      may Unix systems), newline to carriage return (use-
	      ful on many BBS hosts), and my favorite,	meta  key
	      tranlation:  to  send  keys  pressed while the meta
	      (ALT) key is held down as an escape (ESC)	followed
	      by  the  key  press.  The latter mode simulates the
	      meta key on hosts that do not  support  8-bit-clean
	      connections  and makes possible the use of the meta
	      key in programs like Emacs on such hosts.

	      * Other features: interactive  setting  of  program
	      parameters,  on-line help, software (XONN/XOFF) and
	      hardware (RTS/CTS) flow control, session capture to
	      a	file,	and temporary running of a local shell in
	      the terminal emulation window.

       Seyon is intended to be both simple and	extensively  con-
       figurable.  Almost every aspect of Seyon can be configured
       via the resources to suit the user's taste.

OPTIONS
       Besides the toolkit options, Seyon recognizes the  follow-
       ing command-line switches:

       -modems <device-list>
	      Overrides	the	resource  modems.  Refer  to  the
	      description of that  resource  below.   Unlike  the
	      resource,	however,  the list here has to be quoted
	      if it consists of more than one entry.

       -emulator <terminal-emulation-program>
	      Instructs Seyon to use the specified program as the
	      terminal	emulator.  If Seyon fails to execute that
	      program, it will fall back to xterm. If this option
	      is  not  given,  Seyon  will  try to use seyon-emu,
	      which should be a link to	your  favorite	terminal
	      emulation program. Seyon will fall back to xterm in

								2

	      this case as well if it fails to execute seyon-emu.

       --     This switch instructs Seyon to pass the rest of the
	      command-line to the terminal emulation program. All
	      options	following  this	switch	will  be  passed
	      blindly to the emulator. This switch cannot be com-
	      bined with -noemulator.

       -nodefargs
	      Seyon  usually  invokes the terminal emulation pro-
	      gram with some options to set the application  name
	      and  window  and icon titles (those are -name Seyon
	      -T "Seyon Terminal Emulator" -n Terminal). If  this
	      switch  is given, Seyon will not pass those options
	      to the emulator.	This is to  accommodate	terminal
	      emulation	programs  that	use a different command-
	      line syntax than xterm -- like xvt, cmdtool, shell-
	      tool,  ..etc.  You  can use the '--' switch to pass
	      your own options to the emulator.

       -noemulator
	      This option is valid only if Seyon is invoked  from
	      withen  a	terminal  emulation program in the fore-
	      ground of an interactive shell session.  If  given,
	      Seyon  will not launch a new terminal emulator, but
	      will use the existing one instead. You  cannot  use
	      the '--' switch if this option is given.

       -script <script-file>
	      Causes  Seyon  to automatically executes the speci-
	      fied script after the startup script  is	run.  The
	      specified	script file will be looked for according
	      to the rule mentioned under the description of  the
	      resource scriptDirectory below.

       -entries <entries-list>
	      Overrides	the  resource defaultPhoneEntries. Refer
	      to the description of that resource  below.  Unlike
	      the  resource,  however,	the  list  here has to be
	      quoted if it consists of more than one entry.

       -dial, -nodial
	      Overrides the resource dialAutoStart and sets it to
	      'on' and If both -dial and -nodial are specified on
	      the command-line, the override value  will  be  set
	      according	to  the  last of the two on the command-
	      line.

RESOURCES
       Besides the toolkit resources, Seyon defines the following
       proprietry resources:

								3

       autoZmodem (boolean)
	      Specifies whether Seyon is to look for Zmodem auto-
	      download signature.  If enabled, Seyon will  detect
	      Zmodem  signature	and  execute the action given by
	      the resource autoZmodemAction (typically to start a
	      local  rz).  Otherwise,  Zmodem  signature  will be
	      ignored.	Default value: on

       autoZmodemAction (string)
	      Specifies a simple or compound action that will  be
	      executed	when  Zmodem  auto-download  signature is
	      detected. This action will be executed only if  the
	      resource	autoZmodem  is enabled (see above). Refer
	      to the section entitled SeQuickKeys for a	descrip-
	      tion  of	available actions.  Default value: Shell-
	      Command($rz);

       backspaceTranslation (boolean)
	      Whether to translate user's  backspace  to  delete.
	      When  the remote host is a Unix system, it's better
	      to set this to on, since many Unix systems are  not
	      happy with backspace.  Default value: off

       captureFile (string)
	      The  name of capture file. Seyon will write session
	      captures to this file when capture is enabled. This
	      file  will  be placed in Seyon's default directory.
	      The capture file will not be overwritten by succes-
	      sive  capture sessions. Seyon will merely apped new
	      capture to its end.  Default value: capture

       connectString (string)
	      The modem connect string. This the string	response
	      the  modem  gives	when  a connection is made after
	      dialing.	Default value: CONNECT

       defaultBits (int)
	      The default number of bits (character size).  Seyon
	      will  set	the  number  of  bits	to  this value on
	      startup and will use it for items	in  the  dialing
	      directory	for  which  no	such parameter is given.
	      Valid values are 5, 6, 7, and 8.	Default value: 8

       defaultBPS (string)
	      The default baud rate. Seyon will set the baud rate
	      to  this value on startup and will use it for items
	      in the dialing directory for which no baud rate  is
	      given.  Default value: 9600

       defaultDirectory (string)
	      Seyon's  default	directory.  When  looking for its
	      files, Seyon will first try this default directory,
	      then the current directory. Seyon will also put the
	      capture file in  this  directory.	Default  value:

								4

	      ~/.seyon

       defaultParity (int)
	      The  default  parity.  Seyon will set the parity to
	      this value on startup and will use it for items  in
	      the  dialing  directory for which no such parameter
	      is given. Valid values are 0 (no	parity),  1  (odd
	      parity), and 2 (even parity).  Default value: 0

       defaultPhoneEntries (int array)
	      This  resource  specifies	a list of numbers corre-
	      sponding to the order the entries	in  the  dialing
	      directory	appear at. Seyon will highlight (select)
	      those entries on startup	and  whenever  you  click
	      ``Default''  from	the  dialing  directory. This is
	      useful if there is a set of entries that	you  most
	      frequesntly  dial	that want to be highlghted auto-
	      matically instead of doing that every time by hand.
	      You can override this resource by the -entries com-
	      mand-line switch.	Unlike the command-line  switch,
	      however, the list here should not be quoted. Phone-
	      book entries numbering starts at one.   No  default
	      value.

       defaultStopBits (int)
	      The default number of stop bits. Seyon will set the
	      number of stop bits to this value	on  startup  and
	      will  use it for items in the dialing directory for
	      which no such parameter is given. Valid values  are
	      1 and 2.	Default value: 1

       dialAutoStart (boolean)
	      This  resource  specifies	that  Seyon should start
	      dialing  the  entries  specified	by  the	resource
	      defaultPhoneEntries  (or	its override command-line
	      switch) on startup.  Seyon  will	commence  dialing
	      those  entries  after  executing the startup script
	      and any script specified at  the	command	line.	A
	      more convenient way of automatic dialing on startup
	      is to use the override command-line  switch  -dial,
	      which  overrides	this resource and enables. If the
	      resource is enabled, it can be disabled at the com-
	      mand  line by the override switch -nodial. Refer to
	      the description of these switches	above.	Default
	      value: off

       dialCancelString (string)
	      The string Seyon sends to the modem to cancel dial-
	      ing while in progress.  Default value: ^M

       dialDelay (int)
	      How long in seconds Seyon should wait after no con-
	      nection  is made withen dialTimeOut before ciculat-
	      ing to the next number.  Default value: 10

								5

       dialDirFormat (string)
	      This is a format string that specifies  the  layout
	      of  the  dialing	direcotry.  The default is '%-15s
	      %-15s  %6s  %1c%1c%1c  %1c%1c  %s'   (no	quotes).
	      Briefly:	the  fields represent the host name, num-
	      ber,  the	baud  rate,  bits,  parity,  stop  bits,
	      whether  there  is a custom prefix, suffix, and the
	      script name. You	can  understand	more  what  each
	      field  refers  to	by comparing with dialing direc-
	      tory, fields that use the current setting (via  the
	      keyword CURRENT) are designated by a question mark.
	      Notice that you cannot change the order  the  items
	      in  the  dialing directory appear at, only the for-
	      mat. For example, if the numbers you call	are  all
	      7-digits,	your host names are short, you never use
	      baud rates above 9600, and you like dashes  between
	      the  baud rate, bits, parity, and stop bits fields,
	      then you may prefer to use the format string '%-10s
	      %-8s  %5s-%1c-%1c-%1c  %1c%1c  %s',  which would be
	      narrower than the default format.	Default  value:
	      %-15s %-15s %6s %1c%1c%1c %1c%1c %s

       dialPrefix (string)
	      The  string  Seyon  sends	to  the modem before the
	      phone  number.  To  use  pulse  dialing,	set  this
	      resource to .IR ATDP .  Default value: ATDT

       dialRepeat (int)
	      How  many	times Seyon should try dialing a number.
	      Seyon will give up on dialing a number if	no  con-
	      nection  is  made	after	this many tries.  Default
	      value: 5

       dialSuffix (string)
	      The string Seyon sends to the modem after the phone
	      number.  This  string  has  to  contain  a carraige
	      return or the number will never  get  sent  to  the
	      mode.  Default value: ^M

       dialTimeOut (int)
	      How long in seconds Seyon should wait for a connec-
	      tion to made after dialing is complete. Seyon  will
	      cancel  the dialing if no connection is made withen
	      this period.  Default value: 45

       exitConfirm (boolean)
	      Whether Seyon should prompt for hanguping up before
	      exiting.	If  off-line  and  the	resource  ignore-
	      ModemDCD is set to 'off', Seyon will not prompt for
	      hanging  up  upon	exiting even if this resource is
	      set to Default value: on

       funMessages (string array)