Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SYNCTERM(1)		    General Commands Manual		   SYNCTERM(1)

NAME
       syncterm	- BBS terminal program

SYNOPSIS
       syncterm	[-edly]	[-iifc]	[-llns]	[-t|-r|-h] [-s]	[URL]

DESCRIPTION
       SyncTERM	 is a terminal program designed	specifically for connecting to
       a Bulletin Board	System (BBS)

   Options
       -edly  Specify the "escape delay" in milliseconds for  curses(3)	 mode.
	      Since curses uses	the escape key for its own purposes, using the
	      escape key for other control requires a timeout. If this timeout
	      is  too  low, extended keystrokes	such as	arrow keys will	be in-
	      terpreted	as an escape keypress followed by other	characters. If
	      this delay is too	high, there will be a large delay after	a sin-
	      gle escape is pressed. If	an escape delay	of less	than  10ms  is
	      specified, it is forced to 25ms.

       -iifc
	      Specify  the  interface to use. Depending	on compile options and
	      library availability, not	all interfaces will be	available  for
	      all installations.  If -i	is not specified, SyncTERM will	choose
	      the "best" mode in the following order: SDL, X11,	curses,	 ANSI.
	      The  SDL	mode  specifically can fail in ways that the automatic
	      fallback can not properly	detect (most notably with libGGI  when
	      it  is  enabled  in SDL.)	When this occurs, a specific mode will
	      need to be forced.

	      When -i is specified, only the specified mode will be attempted.
	      No automatic fallback will be performed.

	      Further,	some available modes (such as SDL windowed) can	not be
	      expressly	selected.

	      The possible values for iface are:

	      S	     Require SyncTERM to run in	full-screen SDL	mode. This re-
		     quires  SDL support to have been compiled in, and the li-
		     brary ``libSDL.so'' to be in  the	library	 search	 path.
		     Some distributions	do not create this symlink when	SDL is
		     installed,	but instead only install it when the  develop-
		     ment  package  is installed. In these cases, the develop-
		     ment package must be installed to use SDL modes.

	      X	     Require SyncTERM to run in	X11 mode.  This	 requires  X11
		     support  to  have	been  compiled	in,  and  the  library
		     ``libX11.so'' to be  in  the  library  search  path.   As
		     above, this may require the development package to	be in-
		     stalled.

	      C	     Require SyncTERM to run in	curses mode. This mode as well
		     as	the ANSI mode have special caveats listed in TEXT MODE
		     CAVEATS

	      F	     Require SyncTERM to run in	curses mode and	assume that it
		     is	 valid	to assume that the display in use will display
		     Codepage 437 glyphs for characters	 above	127.   special
		     caveats listed in TEXT MODE CAVEATS

	      A	     Require  SyncTERM	to run in ANSI mode. This mode as well
		     as	the curses mode	have special caveats  (see  TEXT  MODE
		     CAVEATS)

       -llns  Sets the number of screen	lines to lns. Only specific values are
	      allowed for lns and they are: 14,	21, 25,	28, 43,	and 50.	If any
	      other value is chosen, a value of	50 is used.

       -t     Specifies	the default scheme for URL to be telnet://

       -r     Specifies	the default scheme for URL to be rlogin://

       -r     Specifies	the default scheme for URL to be ssh://

       -s     Run  in  "safe  mode"  which  disables the modification of local
	      files such as the	dialing	list.

RUN-TIME LINKING
       For some	features, specifically SSH support, SDL	support, and X11  sup-
       port,  run-time	linking	 is employed using dlopen(). Using this, it is
       possible	to build a version which will use SDL, X11,  and  cryptlib  if
       they are	present, but not fail to run if	they are not.

       Unfortunately,  due  to	some packagers decisions, this can result in a
       binary which supports SDL, X11, and SSH but can not find	 the  required
       libraries. To solve this	issue, the development package needs to	be in-
       stalled.	The files  that	 are  used  are	 libSDL.so  for	 SDL  support,
       libcl.so	for SSH	support, and libX11.so for X11 support.

TEXT MODE CAVAETS
       When  running  in one of	the text modes such as curses or ANSI, many of
       the control functions are modified since	there is no  reliable  way  to
       use extra modifier keys.	As a result, CTRL-S and	CTRL-Q can not be sent
       to the remote system. Since these are the flow control characters, this
       should not present major	usability issues.

       The escape character (ASCII 27) is used in curses and ANSI modes	to be-
       gin a control sequence. As such,	there is a delay to detect if the next
       character continues the escape sequence or is a base escape. Because of
       this, there will	be a perceptible delay when the	escape	key  is	 used.
       This  delay  can	 be adjusted using the -e parameter, but selecting the
       "correct" value is a dark art since any value is	provably incorrect.

       The curses and ANSI modes are not necessarily  the  correct  number  of
       lines  for  a  traditional  screen  mode. As such, filler will be added
       around the terminal screen. For some display sizes,  unpredictable  re-
       sults may occur.

FILES
       /etc/syncterm.lst
	      The system wide dialing directory.

       ~/.syncterm/syncterm.lst
	      The users	dialing	directory

       ~/.syncterm/syncterm.ini
	      The users	SyncTERM configuration file

       libSDL.so
	      When this	file exists in the library path, SyncTERM will support
	      the use of SDL for input and output. This	file is	 part  of  the
	      Simple   Directmedia   Layer  available  from  ``http://www.lib-
	      sdl.org''. See RUN-TIME LINKING for details.

       libX11.so
	      When this	file exists in the library path, SyncTERM will support
	      the  use	of  X11	for input and output. See RUN-TIME LINKING for
	      details.

       libcl.so
	      When this	file exists in the library path, SyncTERM will support
	      the use of SSH connections. This file is part of Peter Gutmann's
	      Cryptlib	 library    available	 from	 ``http://www.cs.auck-
	      land.ac.nz/~pgut001/cryptlib/''.	See  RUN-TIME  LINKING for de-
	      tails.

AUTHOR
       Stephen Hurd <shurd@sasktel.net>

BUGS
       Commodore PETSCII and Atari ATASCII are lightly tested and most	likely
       have problems.

       The  modem  support  is	untested at this time. Further,	it assumes the
       Hayes command set and 115200 bps	rate on	the serial port.

				  27 May 2007			   SYNCTERM(1)

NAME | SYNOPSIS | DESCRIPTION | RUN-TIME LINKING | TEXT MODE CAVAETS | FILES | AUTHOR | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=syncterm&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help