Communication-Mobile

Development Platform:

Windows_Unix

ckuus2.c：Code Content

/* C K U U S 2 -- User interface strings & help text module for C-Kermit */
/*
Authors:
Frank da Cruz <fdc@columbia.edu>,
Jeffrey Altman <jaltman@columbia.edu>,
The Kermit Project
Columbia University
New York City
Trustees of Columbia University in the City of New York.
copyright text in the ckcmai.c module for disclaimer and permissions.
This module contains HELP command and other long text strings.
IMPORTANT: Character string constants longer than about 250 are not portable.
Longer strings should be broken up into arrays of strings and accessed with
hmsga() rather than hmsg().
*/
#include "ckcsym.h"
#include "ckcdeb.h"
#include "ckcnet.h"
#include "ckcasc.h"
#include "ckcker.h"
#include "ckuusr.h"
#include "ckcxla.h"
#ifdef OS2
#ifdef NT
#include <windows.h>
#else /* not NT */
#define INCL_KBD
#ifdef OS2MOUSE
#define INCL_MOU
#endif /* OS2MOUSE */
#define INCL_DOSMISC
#define INCL_DOSDEVICES
#include <os2.h> /* This pulls in a whole load of stuff */
#undef COMMENT
#endif /* NT */
#include "ckocon.h"
#include "ckokvb.h"
#include "ckokey.h"
#endif /* OS2 */
extern xx_strp xxstring;
extern char *ccntab[];
#ifndef NOICP
extern int cmflgs;
#ifdef DCMDBUF
extern char *cmdbuf, *atmbuf;
#else
extern char cmdbuf[], atmbuf[];
#endif /* DCMDBUF */
#endif /* NOICP */
extern char *xarg0;
extern int nrmt, nprm, dfloc, local, parity, escape;
extern int turn, flow;
extern int binary, quiet, keep;
extern int success, xaskmore;
#ifdef OS2
extern int tt_rows[], tt_cols[];
#else /* OS2 */
extern int tt_rows, tt_cols;
#endif /* OS2 */
extern int cmd_rows, cmd_cols;
extern long speed;
extern char *dftty, *versio, *ckxsys;
#ifndef NOHELP
extern char *helpfile;
#endif /* NOHELP */
extern struct keytab prmtab[];
#ifndef NOXFER
extern struct keytab remcmd[];
#endif /* NOXFER */
#ifndef NOICP
/* Interactive help strings */
static char *tophlp[] = {
"Trustees of Columbia University in the City of New York.n",
#ifndef NOHELP
#ifdef OS2
" Type INTRO for a brief introduction to the Kermit Command screen.",
#else
" Type INTRO for a brief introduction to C-Kermit.",
#endif /* OS2 */
" Type VERSION for version and copyright information.",
" Type HELP followed by a command name for help about a specific command.",
#ifndef NOPUSH
#ifdef UNIX
" Type MANUAL to access the C-Kermit manual page.",
#else
#ifdef VMS
" Type MANUAL to access the C-Kermit help topic.",
#else
#ifdef OS2
" Type MANUAL to access the K95 manual.",
#else
" Type MANUAL to access the C-Kermit manual.",
#endif /* OS2 */
#endif /* VMS */
#endif /* UNIX */
#endif /* NOPUSH */
" Type NEWS for news about new features.",
" Type SUPPORT to learn how to get technical support.",
" Press ? (question mark) at the prompt, or anywhere within a command,",
" for a menu (context-sensitive help, menu on demand).",
#else
"Press ? for a list of commands; see documentation for detailed descriptions.",
#endif /* NOHELP */
#ifndef NOCMDL
#ifndef NOHELP
" ",
" Type HELP OPTIONS for help with command-line options.",
#endif /* NOHELP */
#endif /* NOCMDL */
" ",
"DOCUMENTATION: "Using C-Kermit" by Frank da Cruz and Christine M. Gianone,",
"Digital Press / Butterworth-Heinemann, latest edition. Please purchase this",
"book. It shows you how to use C-Kermit, answers your questions, reduces the",
"load on our help desk, and book sales are the primary source of funding for",
"C-Kermit development. More info: http://www.columbia.edu/kermit/.",
#ifdef MAC
" ",
"Also see the Mac Kermit Doc and Bwr files on the Mac Kermit diskette.n",
#else
#ifdef HPUX10
" ",
"See the files in /usr/share/lib/kermit/ for additional information.",
#endif /* HPUX10 */
#endif /* MAC */
""
};
#ifndef NOHELP
char *newstxt[] = {
#ifdef OS2
"Welcome to Kermit 95 1.1.18",
" ",
"Major new features (not necessarily available on all platforms) include:",
#else
"Welcome to C-Kermit 7.0.196.",
" ",
"Major new features (not necessarily available on all platforms) include:",
#endif /* OS2 */
" ",
#ifndef NOIKSD
" . Internet Kermit Service Daemon and client.",
#endif /* NOIKSD */
#ifdef CK_AUTHENTICATION
#ifdef CK_ENCRYPTION
" . Secure network authentication and encryption",
#else
" . Secure network authentication",
#endif /* CK_ENCRYPTION */
#ifdef NETCMD
" . External communication program interface.",
#endif /* NETCMD */
#ifdef NETPTY
" . Scripted control of local programs.",
#endif /* NETPTY */
#endif /* CK_AUTHENTICATION */
" . More-powerful filename-matching patterns",
" . Recursive directory-tree transfer and directory listing.",
" . Automatic per-file text/binary mode switching.",
#ifndef NOFAST
" . Fast Kermit protocol settings are now the default.",
#endif /* NOFAST */
" . File-transfer selection and other option switches (HELP SEND, HELP GET).",
#ifdef PIPESEND
" . File-transfer pipes and filters.",
#endif /* PIPESEND */
" . New streaming Kermit protocol for use on reliable connections.",
#ifdef CKREGEX
" . More-flexible wildcards for filename matching (HELP WILDCARD).",
#endif /* CKREGEX */
#ifndef NOLOCAL
" . Numerous modem and dialing improvements.",
" . More/higher serial speeds on most platforms (SET SPEED ?).",
" . New data-bits/parity/stop-bits options (HELP SET SERIAL).",
#endif /* NOLOCAL */
#ifdef CK_PERMS
" . File-permission preservation in UNIX and VMS.",
#endif /* CK_PERMS */
" . Improvements in CD and other directory-related commands.",
#ifndef NOCSETS
#ifdef UNICODE
" . Unicode - the Universal Character Set (UCS-2 and UTF-8)",
#endif /* UNICODE */
#ifndef NOGREEK
" . Greek character sets.",
#endif /* NOGREEK */
" . New Euro-compliant and other character sets.",
" . Automatic character-set switching (HELP ASSOCIATE).",
#endif /* NOCSETS */
#ifndef NOSPL
" . New script programming features, functions, and variables.",
" . "kerbang" scripts.",
" . General-purpose file i/o and floating-point arithmetic packages.",
#endif /* NOSPL */
#ifdef CXLOGDIAL
" . New connection log (HELP LOG).",
#endif /* CXLOGDIAL */
#ifndef NOHELP
" . New MANUAL command to access online documentation (HELP MANUAL).",
#endif /* NOHELP */
" . Performance improvements.",
" . Bug fixes.",
" ",
"These new features are documented in the ckermit2.txt file, to be used as",
"a supplement to the manual, "Using C-Kermit", second edition (1997),",
"until the third edition is ready.",
#ifdef OS2
" ",
"And in the online Kermit 95 manual, accessible via the MANUAL command.",
#endif /* OS2 */
" ",
"If the release date shown by the VERSION command is long past, be sure to",
"check with the Kermit Project to see if there have been updates.",
""
};
#endif /* NOHELP */
#ifndef NOHELP
char *introtxt[] = {
#ifdef NT
"Welcome to K-95, Kermit communications software for:",
#else
#ifdef OS2
"Welcome to Kermit/2, Kermit communications software for:",
#else
#ifdef UNIX
#ifdef HPUX
"Welcome to HP-UX C-Kermit communications software for:",
#else
"Welcome to UNIX C-Kermit communications software for:",
#endif /* HPUX */
#else
#ifdef VMS
"Welcome to VMS C-Kermit communications software for:",
#else
#ifdef VOS
"Welcome to VOS C-Kermit communications software for:",
#else
#ifdef MAC
"Welcome to Mac Kermit communications software for:",
#else
"Welcome to C-Kermit communications software for:",
#endif /* MAC */
#endif /* VOS */
#endif /* VMS */
#endif /* UNIX */
#endif /* OS2 */
#endif /* NT */
#ifndef NOXFER
" . Error-free and efficient file transfer",
#endif /* NOXFER */
#ifndef NOLOCAL
#ifdef OS2
" . VT320/220/102/100/52, ANSI, Wyse, DG, Televideo, and other emulations",
#else
#ifdef MAC
" . VT220 terminal emulation",
#else
" . Terminal connection",
#endif /* MAC */
#endif /* OS2 */
#endif /* NOLOCAL */
#ifndef NOSPL
" . Script programming",
#endif /* NOSPL */
#ifndef NOICS
" . International character set conversion",
#endif /* NOICS */
#ifndef NOLOCAL
"nSupporting:",
" . Serial connections, direct or dialed.",
#ifndef NODIAL
" . Automatic modem dialing",
#endif /* NODIAL */
#ifdef TCPSOCKET
" . TCP/IP network connections",
#endif /* TCPSOCKET */
#ifdef ANYX25
" . X.25 network connections",
#endif /* ANYX25 */
#ifdef OS2
#ifdef DECNET
" . DECnet/PATHWORKS LAT Ethernet connections",
#endif /* DECNET */
#ifdef SUPERLAT
" . Meridian Technologies' SuperLAT connections",
#endif /* SUPERLAT */
#ifdef NPIPE
" . Named-pipe connections",
#endif /* NPIPE */
#ifdef CK_NETBIOS
" . NETBIOS connections",
#endif /* CK_NETBIOS */
#endif /* OS2 */
#endif /* NOLOCAL */
"nWhile typing commands, you may use the following special characters:",
" . DEL, RUBOUT, BACKSPACE, CTRL-H: Delete the most recent character typed.",
" . CTRL-W: Delete the most recent word typed.",
" . CTRL-U: Delete the current line.",
" . CTRL-R: Redisplay the current line.",
#ifdef CK_RECALL
#ifdef OS2
" . 30 or CTRL-B: Command recall - go backwards in command recall buffer.",
" . 31 or CTRL-N: Command recall - go forward in command recall buffer.",
#else
" . CTRL-P: Command recall - go backwards in command recall buffer.",
" . CTRL-B: Command recall - same as Ctrl-P.",
" . CTRL-N: Command recall - go forward in command recall buffer.",
#endif /* OS2 */
#endif /* CK_RECALL */
" . ? (question mark) Display a menu for the current command field.",
" . ESC (or TAB) Attempt to complete the current field.",
" . \ (backslash) include the following character literally",
#ifndef NOSPL
" or introduce a backslash code, variable, or function.",
#else
" or introduce a numeric backslash code.",
#endif /* NOSPL */
" Command words other than filenames can be abbreviated in most contexts.",
#ifdef OS2
#ifdef NT
"nBasic K-95 commands:",
" EXIT exit from K-95",
#else /* NT */
"nBasic Kermit/2 commands:",
" EXIT exit from Kermit/2",
#endif /* NT */
#else /* OS2 */
"nBasic C-Kermit commands:",
" EXIT exit from C-Kermit",
#endif /* NT */
" HELP request general help",
" HELP command request help about the given command",
" TAKE execute commands from a file",
" TYPE display a file on your screen",
#ifndef NOXFER
"nCommands for file transfer:",
" SEND send files",
" RECEIVE receive files",
" GET get files from a Kermit server",
#ifdef CK_RESEND
" RESEND recover an interrupted send",
" REGET recover an interrupted get from a server",
#endif /* CK_RESEND */
#ifndef NOSERVER
" SERVER be a Kermit server",
#endif /* NOSERVER */
"nFile-transfer speed selection:",
" FAST use fast settings -- THIS IS THE DEFAULT",
" CAUTIOUS use slower, more cautious settings",
" ROBUST use extremely slow and cautious settings",
"nFile-transfer performance fine tuning:",
" SET RECEIVE PACKET-LENGTH Kermit packet size",
" SET WINDOW number of sliding window slots",
" SET PREFIXING amount of control-character prefixing",
#endif /* NOXFER */
"nImportant settings:",
" SET PARITY communications parity",
#ifdef CK_RTSCTS
" SET FLOW communications flow control, such as RTS/CTS",
#else
" SET FLOW communications flow control, such as XON/XOFF",
#endif /* CK_RTSCTS */
" SET FILE file settings, for example TYPE TEXT or TYPE BINARY",
#ifndef NOLOCAL
"nTo make a direct serial connection:",
#ifdef OS2
#ifdef NT
#ifdef CK_TAPI
" SET TAPI LINE select TAPI communication device",
#endif /* CK_TAPI */
" SET PORT select serial communication device",
#else
" SET PORT select serial communication port or server",
#endif /* NT */
#else
" SET LINE select serial communication device",
#endif /* OS2 */
" SET SPEED select communication speed",
" CONNECT begin terminal connection",
#ifndef NODIAL
"nTo dial out with a modem:",
" SET DIAL DIRECTORY specify dialing directory file (optional)",
" SET DIAL COUNTRY-CODE country you are dialing from (*)",
" SET DIAL AREA-CODE area-code you are dialing from (*)",
" LOOKUP lookup entries in your dialing directory (*)",
" SET MODEM TYPE select modem type",
#ifdef OS2
#ifdef NT
#ifdef CK_TAPI
" SET TAPI LINE select TAPI communication device",
#endif /* CK_TAPI */
" SET PORT select serial communication device",
#else
" SET PORT select serial communication port or server",
#endif /* NT */
#else
" SET LINE select serial communication device",
#endif /* OS2 */
" SET SPEED select communication speed",
" DIAL dial the phone number",
" CONNECT begin terminal connection",
#ifdef OS2
"Further info: HELP DIAL, HELP SET MODEM, HELP SET PORT, HELP SET DIAL",
#else
"Further info: HELP DIAL, HELP SET MODEM, HELP SET LINE, HELP SET DIAL",
#endif /* OS2 */
"(*) (For use with optional dialing directory)",
#endif /* NODIAL */
#ifdef NETCONN
"nTo make a network connection:",
#ifndef NODIAL
" SET NETWORK DIRECTORY Specify a network services directory (optional)",
" LOOKUP Lookup entries in your network directory",
#endif /* NODIAL */
" SET NETWORK TYPE Select network type (if more than one available)",
" SET HOST Make a network connection but stay in command mode",
" CONNECT Begin terminal connection",
#ifdef TNCODE
" TELNET Select a TCP/IP host and CONNECT to it",
#endif /* TNCODE */
#ifdef RLOGCODE
" RLOGIN Select a TCP/IP host and RLOGIN to it",
#endif /* RLOGCODE */
#endif /* NETCONN */
#ifdef NT
"nTo return from the terminal window to the K-95> prompt:",
#else
#ifdef OS2
"nTo return from the terminal window to the K/2> prompt:",
#else
"nTo return from a terminal connection to the C-Kermit prompt:",
#endif /* OS2 */
#endif /* NT */
#ifdef OS2
"
Press the key or key-combination shown after "Prompt:" in the status line",
" (such as Alt-x) or type your escape character followed by the letter C.",
#else
" Type your escape character followed by the letter C.",
#endif /* OS2 */
" ",
"To display your escape character:",
" SHOW ESCAPE",
" ",
"To display other settings:",
" SHOW COMMUNICATIONS, SHOW TERMINAL, SHOW FILE, SHOW PROTOCOL, etc.",
#else /* !NOLOCAL */
" ",
"To display settings:",
" SHOW COMMUNICATIONS, SHOW FILE, SHOW PROTOCOL, etc.",
#endif /* NOLOCAL */
" ",
"For further information about a particular command, type HELP xxx,",
"where xxx is the name of the command. For documentation, news of new",
"releases, and information about other Kermit software, contact:",
" ",
" The Kermit Project E-mail: kermit-orders@columbia.edu",
" Columbia University Web: http://www.columbia.edu/kermit/",
" 612 West 115th Street Voice: +1 (212) 854-3703",
" New York NY 10025-7799 Fax: +1 (212) 663-8202",
" USA",
""
};
static char *hmxxscrn[] = {
"Syntax: SCREEN { CLEAR, CLEOL, MOVE row column }",
#ifdef OS2
" Performs screen-formatting actions.",
#else
" Performs screen-formatting actions. Correct operation of these commands",
" depends on proper terminal setup on both ends of the connection -- mainly",
" that the host terminal type is set to agree with the kind of terminal or",
" the emulation you are viewing C-Kermit through.",
#endif /* OS2 */
" ",
"SCREEN CLEAR",
" Moves the cursor to home position and clears the entire screen.",
#ifdef OS2
" Synonyms: CLS, CLEAR SCREEN, CLEAR COMMAND-SCREEN ALL",
#else
" Synonyms: CLS, CLEAR SCREEN.",
#endif /* OS2 */
" ",
"SCREEN CLEOL",
" Clears from the current cursor position to the end of the line.",
#ifdef OS2
" Synonym: CLEAR COMMAND-SCREEN EOL",
#endif /* OS2 */
" ",
"SCREEN MOVE row column",
" Moves the cursor to the indicated row and column. The row and column",
" numbers are 1-based so on a 24x80 screen, the home position is 1 1 and",
" the lower right corner is 24 80. If a row or column number is given that",
" too large for what Kermit or the operating system thinks is your screen",
" size, the appropriate number is substituted.",
" ",
"Also see:",
#ifdef OS2
" HELP FUNCTION SCRNCURX, HELP FUNCTION SCRNCURY, HELP FUNCTION SCRSTR,",
#endif /* OS2 */
" SHOW VARIABLE TERMINAL, SHOW VARIABLE COLS, SHOW VAR ROWS, SHOW COMMAND.",
""
};
#ifndef NOSPL
static char *hxxinp[] = {
"Syntax: INPUT { number-of-seconds, time-of-day } [ text ]",
"Example: INPUT 5 Login: or INPUT 23:59:59 RING",
" Waits up to the given number of seconds, or until the given time of day",
" for the given text to arrive on the connection. If no text is given,",
" INPUT waits for any character. For use in script programs with IF FAILURE",
" and IF SUCCESS. Also see MINPUT, REINPUT, SET INPUT. See HELP PAUSE for",
" details on time-of-day format. The text, if given, can be a \pattern()",
" invocation, in which case it is treated as a regular expression rather than"
,
" a literal string (HELP REGULAR-EXPRESSIONS for details).",
""};
static char *hxxout[] = {
"Syntax: OUTPUT textn",
" Sends the text out the communications connection, as if you had typed it",
" during CONNECT mode. The text may contain backslash codes, variables,",
" etc, plus the following special codes:",
" ",
" \N - Send a NUL (ASCII 0) character (you can't use \0 for this).",
" \B - Send a BREAK signal.",
" \L - Send a Long BREAK signal.",
" ",
"Also see SET OUTPUT.",
"" };
#endif /* NOSPL */
static char *hxypari[] = {
"SET PARITY NONE",
" Chooses 8 data bits and no parity.",
" ",
"SET PARITY { EVEN, ODD, MARK, SPACE }",
" Chooses 7 data bits plus the indicated kind of parity.",
" Forces 8th-bit prefixing during file transfer.",
" ",
#ifdef HWPARITY
"SET PARITY HARDWARE { EVEN, ODD }",
" Chooses 8 data bits plus the indicated kind of parity.",
" ",
"Also see SET TERMINAL BYTESIZE, SET SERIAL, and SET STOP-BITS.",
#else
"Also see SET TERMINAL BYTESIZE and SET SERIAL.",
#endif /* HWPARITY */
""};
#ifndef NOLOCAL
static char *hxyesc[] = {
#ifdef OS2
"Syntax: SET ESCAPE number",
" Decimal ASCII value for escape character during CONNECT, normally 29",
" (Control-]). Type the escape character followed by C to get back to the",
" C-Kermit prompt or followed by ? to see other options, or use the \Kexit",
" keyboard verb, normally assigned to Alt-x.",
#else
#ifdef NEXT
"Syntax: SET ESCAPE number",
" Decimal ASCII value for escape character during CONNECT, normally 29",
" (Control-]). Type the escape character followed by C to get back to the",
" C-Kermit prompt or followed by ? to see other options.",
#else
"Syntax: SET ESCAPE number",
" Decimal ASCII value for escape character during CONNECT, normally 28",
" (Control-\). Type the escape character followed by C to get back to the",
" C-Kermit prompt or followed by ? to see other options.",
#endif /* NEXT */
#endif /* OS2 */
" ",
"You may also enter the escape character as ^X (circumflex followed by a",
"letter or one of: @, ^, _, [, \, or ], to indicate a control character;",
"for example, SET ESC ^_ sets your escape character to Ctrl-Underscore.",
"" };
#endif /* NOLOCAL */
#ifndef NOSPL
static char *hxyout[] = {
"SET OUTPUT PACING <number>n",
" How many milliseconds to pause after sending each OUTPUT character,",
" normally 0.",
" ",
"SET OUTPUT SPECIAL-ESCAPES { ON, OFF }n",
" Whether to process the special OUTPUT-only escapes \B, \L, and \N.",
" Normally ON (they are processed).",
"" };
static char *hxyinp[] = {
"Syntax: SET INPUT parameter value",
" ",
#ifdef CK_AUTODL
"SET INPUT AUTODOWNLOAD { ON, OFF }",
" Controls whether autodownloads are allowed during INPUT command execution.",
" ",
#endif /* CK_AUTODL */
"SET INPUT BUFFER-LENGTH number-of-bytes",
" Removes the old INPUT buffer and creates a new one with the given length.",
" ",
"SET INPUT CANCELLATION { ON, OFF }",
"Whether an INPUT in progress can be can interrupted from the keyboard.",
" ",
"SET INPUT CASE { IGNORE, OBSERVE }",
" Tells whether alphabetic case is to be significant in string comparisons.",
" This setting is local to the current macro or command file, and is",
" inherited by subordinate macros and take files.",
" ",
"SET INPUT ECHO { ON, OFF }",
" Tells whether to display arriving characters read by INPUT on the screen.",
" ",
"SET INPUT SILENCE <number>",
" The maximum number to seconds of silence (no input at all) before the",
" INPUT command times out, 0 for no maximum.",
" ",
#ifdef OS2
"SET INPUT TERMINAL { ON, OFF }",
" Determines whether the data received during an INPUT command is displayed",
" in the terminal window. Default is ON.",
" ",
#endif /* OS2 */
"SET INPUT TIMEOUT-ACTION { PROCEED, QUIT }",
" Tells whether to proceed or quit from a script program if an INPUT command",
" fails. PROCEED (default) allows use of IF SUCCESS / IF FAILURE commands.",
" This setting is local to the current macro or command file, and is",
" inherited by subordinate macros and take files.",
"" };
static char *hxyfunc[] = {
"SET FUNCTION DIAGNOSTICS { ON, OFF }",
" Whether to issue diagnostic messages for illegal function calls and",
" references to nonexistent built-in variables. ON by default.",
" ",
"SET FUNCTION ERROR { ON, OFF }",
" Whether an illegal function call or reference to a nonexistent built-in",
" variable should cause a command to fail. OFF by default.",
"" };
#endif /* NOSPL */
static char *hxyxyz[] = {
#ifdef CK_XYZ
#ifdef XYZ_INTERNAL
/* This is for built-in protocols */
"Syntax: SET PROTOCOL { KERMIT, XMODEM, YMODEM, ZMODEM } [ s1 s2 [ s3 ] ]",
" Selects protocol to use for transferring files. String s1 is a command to",
" send to the remote host prior to SENDing files with this protocol in",
" binary mode; string s2 is the same thing but for text mode. Use "%" in",
" any of these strings to represent the filename(s). If the protocol is",
" KERMIT, you may also specify a string s3, the command to start a Kermit",
" server on the remote host when you give a GET, REGET, REMOTE, or other",
" client command. Use { braces } if any command contains spaces. Examples:",
" ",
" set proto xmodem {rx %s} {rx -a %s}",
" set proto kermit {kermit -YQir} {kermit -YQTr} {kermit -YQx}",
#else /* This is for when non-Kermit protocols are external */
"Syntax:
SET PROTOCOL { KERMIT, XMODEM, YMODEM, ZMODEM } [ s1 s2 s3 s4 s5 s6 ]",
" Selects protocol to use for transferring files. s1 and s2 are commands to",
" output prior to SENDing with this protocol, to automatically start the",
" RECEIVE process on the other end in binary or text mode, respectively.",
" If the protocol is KERMIT, s3 is the command to start a Kermit server on",
" the remote computer, and there are no s4-s6 commands. Otherwise, s3 and",
" s4 are commands used on this computer for sending files with this protocol",
" in binary or text mode, respectively; s5 and s6 are the commands for",
" receiving files with this protocol. Use "%s" in any of these strings",
" to represent the filename(s). Use { braces } if any command contains",
" spaces. Examples:",
" ",
" set proto kermit {kermit -YQir} {kermit -YQTr} {kermit -YQx}",
" set proto ymodem rb {rb -a} {sb %s} {sb -a %s} rb rb",
" ",
"External protocols require REDIRECT and external file transfer programs that",
"use redirectable standard input/output.",
#endif /* XYZ_INTERNAL */
#else
"Syntax:
SET PROTOCOL KERMIT [ s1 [ s2 [ s3 ] ] ]",
" Lets you specify the autoupload binary, autoupload text, and autoserver",
" command strings to be sent to the remote system in advance of any SEND",
" or GET commands. By default these are "kermit -ir", "kermit -r", and",
" "kermit -x". Use { braces } around any command that contains spaces.",
" Example:",
" ",
" set proto kermit {kermit -YQir} {kermit -YQTr} {kermit -YQx}",
#endif /* CK_XYZ */
" ",
" SHOW PROTOCOL displays the current settings.",
""};
static char *hmxxbye = "Syntax: BYEn
Shut down and log out a remote Kermit server";
static char *hmxxdir[] = {
#ifdef DOMYDIR
"Syntax: DIRECTORY [ switches ] [ filespec ]",
" Lists files. The filespec may be a filename, possibly containing wildcard",
" characters, or a directory name. If no filespec is given, all files in",
" the current directory are listed. If a directory name is given, all the",
" files in it are listed. Optional switches:",
" ",
" /BRIEF List filenames only.",
#ifdef CK_PERMS
" /VERBOSE + Also list permissions, size, and date.",
#else
" /VERBOSE + Also list date and size.",
#endif /* CK_PERMS */
" /FILES Show files but not directories.",
" /DIRECTORIES Show directories but not files.",
" /ALL + Show both files and directories.",
" /ARRAY:&a Store file list in specified array (e.g. \%a[]).",
" /PAGE Pause after each screenful.",
" /NOPAGE Don't pause after each screenful.",
#ifdef UNIXOROSK
" /DOTFILES Include files whose names start with dot (period).",
" /NODOTFILES + Don't include files whose names start with dot.",
" /BACKUP + Include backup files (names end with .~n~).",
" /NOBACKUP Don't include backup files.",
#endif /* UNIXOROSK */
" /HEADING Include heading and summary.",
" /NOHEADING + Don't include heading or summary.",
" /XFERMODE Show pattern-based transfer mode (T=Text, B=Binary).",
" /MESSAGE:text Add brief message to each listing line.",
" /NOMESSAGE + Don't add message to each listing line.",
" /NOXFERMODE + Don't show pattern-based transfer mode",
" /ISODATE + In verbose listings, show date in ISO 8061 format.",
" /ENGLISHDATE In verbose listings, show date in "English" format.",
#ifdef RECURSIVE
" /RECURSIVE Descend through subdirectories.",
" /NORECURSIVE + Don't descend through subdirectories.",
#endif /* RECURSIVE */
" /SORT:key Sort by key, NAME, DATE, or SIZE; default key is NAME.",
" /NOSORT + Don't sort.",
" /ASCENDING + If sorting, sort in ascending order.",
" /REVERSE If sorting, sort in reverse order.",
" ",
"Factory defaults are marked with +. Default for paging depends on SET",
"COMMAND MORE-PROMPTING. Use SET OPTIONS DIRECTORY [ switches ] to change",
"defaults; use SHOW OPTIONS to display customized defaults.",
#else
"Syntax: DIRECTORY [ filespec ]",
" Lists the specified file or files. If no filespec is given, all files",
" in the current directory are listed.",
#endif /* DOMYDIR */
""};
static char *hmxxdel[] = {
"Syntax: DELETE [ switches... ] filespec",
" Deletes a file or files on the computer where C-Kermit is running.",
" The filespec may denote a single file or can include wildcard characters",
" to match multiple files. RM is a synonym for DELETE. Switches include:",
" ",
"/AFTER:date-time",
#ifdef VMS
" Specifies that only those files created after the given date-time are",
#else
" Specifies that only those files modified after the given date-time are",
#endif /* VMS */
" to be deleted. HELP DATE for info about date-time formats.",
" ",
"/BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified before the given date-time",
#else
" Specifies that only those files modified before the given date-time",
#endif /* VMS */
" are to be deleted.",
" ",
"/NOT-AFTER:date-time",
#ifdef VMS
" Specifies that only those files modified at or before the given date-time",
#else
" Specifies that only those files modified at or before the given date-time",
#endif /* VMS */
" are to be deleted.",
" ",
"/NOT-BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified at or after the given date-time",
#else
" Specifies that only those files modified at or after the given date-time",
#endif /* VMS */
" are to be deleted.",
" ",
"/LARGER-THAN:number",
" Specifies that only those files longer than the given number of bytes are",
" to be deleted.",
" ",
"/SMALLER-THAN:number",
" Specifies that only those files smaller than the given number of bytes are",
" to be sent.",
" ",
"/EXCEPT:pattern",
" Specifies that any files whose names match the pattern, which can be a",
" regular filename or may contain wildcards, are not to be deleted. To",
" specify multiple patterns (up to 8), use outer braces around the group",
" and inner braces around each pattern:",
" ",
" /EXCEPT:{{pattern1}{pattern2}...}",
" ",
#ifdef UNIXOROSK
"/DOTFILES",
" Include (delete) files whose names begin with ".".",
" ",
"/NODOTFILES",
" Skip (don't delete) files whose names begin with ".".",
" ",
#endif /* UNIXOROSK */
"/LIST",
" List each file and tell whether it was deleted. Synonyms: /LOG, /VERBOSE.",
" ",
"/NOLIST",
" Don't list files while deleting. Synonyms: /NOLOG, /QUIET.",
" ",
"/HEADING",
" Print heading and summary information.",
" ",
"/NOHEADING",
" Don't print heading and summary information.",
" ",
"/PAGE",
" If listing, pause after each screenful.",
" ",
"/NOPAGE",
" Don't pause after each screenful.",
" ",
"/ASK",
" Interactively ask permission to delete each file.",
" ",
"/NOASK",
" Delete files without asking permission.",
" ",
"/SIMULATE",
" Preview files selected for deletion without actually deleting them.",
" Implies /LIST.",
" ",
"Use SET OPTIONS DELETE to make selected switches effective for every DELETE",
"command
unless you override them; use SHOW OPTIONS to see selections currently",
"in effect. Also see HELP PURGE, HELP WILDCARD.",
""};
#ifndef NOHTTP
static char *hmxxhttp[] = {
"Syntax:",
"HTTP [ <switches> ] GET <remote-filename> [ <local-filename> ]",
" Retrieves the named file. If a <local-filename> is given, the file is",
" stored locally under that name; otherwise it is stored with its own name.",
" ",
"HTTP [ <switches> ] HEAD <remote-filename> <local-filename>",
" Like GET except without actually getting the file; instead it gets only",
" the headers, storing them into the given file, whose name must be given,",
" one line per header item, as shown in the /ARRAY: switch description.",
" ",
"HTTP [ <switches> ] INDEX <remote-directory> [ <local-filename> ]",
" Retrieves the file listing for the given server directory.",
" NOTE: This command is not supported by most Web servers.",
" ",
"HTTP [ <switches> ] POST [ /MIME-TYPE:<type> ] <local-file> <remote-file>",
" Used to send a response as if it were sent from a form. The data to be",
" posted must be read from a file.",
" ",
"HTTP [ <switches> ] PUT [ /MIME-TYPE:<type> ] <local-file> <remote-file>",
" Uploads a local file to a server file.",
" ",
"HTTP [ <switches> ] DELETE <remote-filename>",
" Instructs the server to delete the specified filename.",
" ",
"where <switches> are:",
"/AGENT:<user-agent>",
" Identifies the client to the server; "C-Kermit" or "Kermit-95"",
" by default.",
" ",
"/HEADER:<header-line>",
" Used for specifying any optional headers. A list of headers is provided",
" using braces for grouping:",
" ",
" /HEADER:{{<tag>:<value>}{<tag>:<value>}...}",
" ",
" For a listing of valid <tag> value and <value> formats see RFC 1945:",
" "Hypertext Transfer Protocol -- HTTP/1.0". A maximum of eight headers",
" may be specified.",
" ",
"/USER:<name>",
" In case a page requires a username for access.",
" ",
"/PASSWORD:<password>",
" In case a page requires a password for access.",
" ",
"/ARRAY:<arrayname>",
" Tells Kermit to store the response headers in the given array, one line",
" per element. The array need not be declared in advance. Example:",
" ",
" http /array:c get kermit/index.html",
" show array c",
" Dimension = 9",
" 1. Date: Fri, 26 Nov 1999 23:12:22 GMT",
" 2. Server: Apache/1.3.4 (Unix)",
" 3. Last-Modified: Mon, 06 Sep 1999 22:35:58 GMT",
" 4. ETag: "bc049-f72-37d441ce"",
" 5. Accept-Ranges: bytes",
" 6. Content-Length: 3954",
" 7. Connection: close ",
" 8. Content-Type: text/html",
" ",
"As you can see, the header lines are like MIME e-mail header lines:",
"identifier, colon, value. The /ARRAY switch is the only method available",
"to a script to process the server responses for a POST or PUT command.",
" ",
"The HTTP commands are only applicable when a connection has already been",
"established to a host using the SET HOST command.",
" ",
#ifdef CK_SSL
"HTTP over SSLv3 or TLSv1 made be performed by using the /SSL or /TLS",
"protocol switches when establishing the connection with SET HOST.",
" ",
#endif /* CK_SSL */
""
};
#endif /* NOHTTP */
#ifdef CK_KERBEROS
static char *hmxxauth[] = {
"Syntax:",
"AUTHENTICATE { KERBEROS4, KERBEROS5 [ switches ] } <action> [ switches ]",
" Obtains or destroys Kerberos tickets and lists information about them.",
" Actions are INITIALIZE, DESTROY, and LIST-CREDENTIALS. KERBEROS4 can be",
" abbreviated K4 or KRB4; KERBEROS5 can be abbreviated K5 or KRB5. Use ? to",
" see which keywords, switches, or other quantities are valid at each point",
" in the command.",
" ",
" The actions are INITIALIZE, DESTROY, and LIST-CREDENTIALS:",
" ",
" AUTH { K4, K5 } { INITIALIZE [switches], DESTROY,",
" LIST-CREDENTIALS [switches] }",
" ",
" The INITIALIZE action is the most complex, and its format is different",
" for Kerberos 4 and Kerberos 5. The format for Kerberos 4 is:",
" ",
" AUTH K4 INITIALIZE [ /INSTANCE:<name> /LIFETIME:<minutes> -",
" /PASSWORD:<password> /PREAUTH /REALM:<name> <principal> ]",
" ",
" All switches are optional. Kerberos 4 INITIALIZE switches are:",
" ",
" /INSTANCE:<name>",
" Allows an Instance (such as a hostname) to be specified.",
" ",
" /LIFETIME:<number>",
" Specifies the requested lifetime in minutes for the ticket. If no",
" lifetime is specified, 600 minutes is used. If the lifetime is greater",
" than the maximum supported by the ticket granting service, the resulting",
" lifetime is shortened accordingly.",
" ",
" /NOT-PREAUTH",
" Instructs Kermit to send a ticket getting ticket (TGT) request to the",
" KDC without any preauthentication data.",
" ",
" /PASSWORD:<string>",
" Allows a password to be included on the command line or in a script",
" file. If no /PASSWORD switch is included, you are prompted on a separate"
,
" line. The password switch is provided on a use-at-your-own-risk basis",
" for use in automated scripts. WARNING: Passwords should not be stored in"
,
" files.",
" ",
" /PREAUTH",
" Instructs Kermit to send a preauthenticated Ticket-Getting Ticket (TGT)",
" request to the KDC instead of a plaintext request. The default when",
" supported by the Kerberos libraries.",
" ",
" /REALM:<name>",
" Allows a realm to be specified (overriding the default realm).",
" ",
" <principal>",
" Your identity in the given or default Kerberos realm, of the form:",
" userid[.instance[.instance]]@[realm] ",
" Can be omitted if it is the same as your username or SET LOGIN USERID",
" value on the client system.",
" ",
" The format for Kerberos 5 is as follows:",
" ",
" AUTH K5 [ /CACHE:<filename> ] { INITIALIZE [ switches ], DESTROY,",
" LIST-CREDENTIALS ...}",
" ",
"The INITIALIZE command for Kerberos 5 can include a number of switches;",
"all are optional:",
" ",
"AUTH K5 [ /CACHE:<filename> ] INITITIALIZE [ /ADDRESSES:<addr-list>",
" /FORWARDABLE /KERBEROS4 /LIFETIME:<minutes> /PASSWORD:<password>",
" /POSTDATE:<date-time> /PROXIABLE /REALM:<name> /RENEW /RENEWABLE:<minutes>",
" /SERVICE:<name> /VALIDATE <principal> ]",
" ",
" All Kerberos 5 INITIALIZE switches are optional:",
" ",
" /ADDRESSES:{list of ip-addresses}",
" Specifies a list of IP addresses that should be placed in the Ticket",
" Getting Ticket in addition to the local machine addresses.",
" ",
" /FORWARDABLE",
" Requests forwardable tickets.",
" ",
" /INSTANCE:<name>",
" Allows an Instance (such as a hostname) to be specified.",
" ",
" /KERBEROS4",
" Instructs Kermit to get Kerberos 4 tickets in addition to Kerberos 5",
" tickets. If Kerberos 5 tickets are not supported by the server, a",
" mild warning is printed and Kerberos 4 tickets are requested.",
" ",
" /LIFETIME:<number>",
" Specifies the requested lifetime in minutes for the ticket. If no",
" lifetime is specified, 600 minutes is used. If the lifetime is greater",
" than the maximum supported by the ticket granting service, the resulting",
" lifetime is shortened.",
" ",
" /NO-KERBEROS4",
" Instructs Kermit to not attempt to retrieve Kerberos 4 credentials.",
" ",
" /NOT-FORWARDABLE",
" Requests non-forwardable tickets.",
" ",
" /NOT-PROXIABLE",
" Requests non-proxiable tickets.",
" ",
" /PASSWORD:<string>",
" Allows a password to be included on the command line or in a script",
" file. If no /PASSWORD switch is included, you are prompted on a separate"
,
" line. The password switch is provided on a use-at-your-own-risk basis",
" for use in automated scripts. WARNING: Passwords should not be stored in"
,
" files.",
" ",
" /POSTDATE:<date-time>",
" Requests a postdated ticket, valid starting at <date-time>. Postdated",
" tickets are issued with the invalid flag set, and need to be fed back to",
" the KDC before use with the /VALIDATE switch. Type HELP DATE for info",
" on date-time formats.",
" ",
" /PROXIABLE",
" Requests proxiable tickets.",
" ",
" /REALM:<string>",
" Allows an alternative realm to be specified.",
" ",
" /RENEW",
" Requests renewal of a renewable Ticket-Granting Ticket. Note that ",
" an expired ticket cannot be renewed even if it is within its renewable ",
" lifetime.",
" ",
" /RENEWABLE:<number>",
" Requests renewable tickets, with a total lifetime of <number> minutes.",
" ",
" /SERVICE:<string>",
" Allows a service other than the ticket granting service to be specified.",
" ",
" /VALIDATE",
" Requests that the Ticket Granting Ticket in the cache (with the invalid",
" flag set) be passed to the KDC for validation. If the ticket is within",
" its requested time range, the cache is replaced with the validated",
" ticket.",
" ",
" <principal>",
" Your identity in the given or default Kerberos realm, of the form:",
" userid[/instance][@realm] ",
" Can be omitted if it is the same as your username or SET LOGIN USERID",
" value on the client system.",
" ",
" Note: Kerberos 5 always attempts to retrieve a Ticket-Getting Ticket (TGT)",
" using the preauthenticated TGT request.",
" ",
" AUTHORIZE K5 LIST-CREDENTIALS [ /ADDRESSES /FLAGS /ENCRYPTION ]",
" ",
" Shows start time, expiration time, service or principal name, plus",
" the following additional information depending the switches:",
" ",
" /ADDRESSES displays the hostnames and/or IP addresses embedded within",
" the tickets.",
" ",
" /FLAGS provides the following information (if applicable) for each ticket:",
" F - Ticket is Forwardable",
" f - Ticket was Forwarded",
" P - Ticket is Proxiable",
" p - Ticket is a Proxy",
" D - Ticket may be Postdated",
" d - Ticket has been Postdated",
" i - Ticket is Invalid",
" R - Ticket is Renewable",
" I - Ticket is the Initial Ticket",
" H - Ticket has been authenticated by Hardware",
" A - Ticket has been Pre-authenticated",
" ",
" /ENCRYPTION displays the encryption used by each ticket (if applicable):",
" DES-CBC-CRC",
" DES-CBC-MD4",
" DES-CBC-MD5",
" DES3-CBC-SHA",
""
};
#endif /* CK_KERBEROS */
#ifndef NOCSETS
static char *hmxxassoc[] = {
"ASSOCIATE FILE-CHARACTER-SET <file-character-set> <transfer-character-set>",
" Tells C-Kermit that whenever the given file-character set is selected, and",
" SEND CHARACTER-SET (q.v.) is AUTOMATIC, the given transfer character-set",
" is selected automatically.",
" ",
"ASSOCIATE XFER-CHARACTER-SET <xfer-character-set> <file-character-set>",
" Tells C-Kermit that whenever the given transfer-character set is selected,",
" either by command or by an announcer attached to an incoming text file,",
" and SEND CHARACTER-SET is AUTOMATIC, the specified file character-set is",
" to be selected automatically. Synonym: ASSOCIATE TRANSFER-CHARACTER-SET.",
" ",
"Use SHOW ASSOCIATIONS to list the current character-set associations, and",
"SHOW CHARACTER-SETS to list the current settings.",
""
};
#endif /* NOCSETS */
static char *hmxxwild[] = {
"A "wildcard" or "regular expression" is notation used in a filename",
"to match multiple files or in a search string when searching through text.",
"For example, in "send *.txt" the asterisk is a wildcard. Kermit commands",
"that accept filenames also accepts wildcards, except commands that are",
"allowed to operate on only one file, such as TRANSMIT or COPY.",
"This version of Kermit accepts the following wildcards:",
" ",
"* Matches any sequence of zero or more characters. For example, "ck*.c"",
" matches all files whose names start with "ck" and end with ".c"",
" including "ck.c".",
" ",
#ifdef VMS
"% Matches any single character. For example, "ck%.c" matches all files",
#else
"? Matches any single character. For example, "ck?.c" matches all files",
#endif /* VMS */
" whose names are exactly 5 characters long and start with "ck" and end",
#ifdef VMS
" with ".c".",
#else
" with ".c". When typing commands at the prompt, you must precede any",
" question mark to be used for matching by a backslash (\) to override the",
" normal function of question mark, which is providing menus and file lists.",
#endif /* VMS */
" ",
#ifdef OS2ORUNIX
#ifdef CKREGEX
"[abc]",
" Square brackets enclosing a list of characters matches any character in",
" the list. Example: ckuusr.[ch] matches ckuusr.c and ckuusr.h.",
" ",
"[a-z]",
" Square brackets enclosing a range of characters matches any character in",
" the range; a hyphen (-) separates the low and high elements of the range.",
" For example, [a-z] matches any character from a to z.",
" ",
"[acdm-z]",
" Lists and ranges may be combined. This example matches a, c, d, or any",
" letter from m through z.",
" ",
"{string1,string2,...}",
" Braces enclose a list of strings to be matched. For example:",
" ck{ufio,vcon,cmai}.c matches ckufio.c, ckvcon.c, or ckcmai.c. The strings",
" may themselves contain *, ?, [abc], [a-z], or other lists of strings.",
#endif /* CKREGEX */
#endif /* OS2ORUNIX */
#ifndef NOSPL
" ",
"To force a special pattern character to be taken literally, precede it with",
"a backslash, e.g. [a\-z] matches a, hyphen, and z rather than a through z.",
" ",
"The same wildcard syntax can be used for patterns in the IF MATCH command,",
"in SWITCH case labels, the \fsearch(), \frsearch(), \fpattern(), and",
"\farraylook() functions, and in file binary- and text-patterns (see HELP IF,"
,
"HELP SWITCH, HELP FUNC, HELP SET FILE).",
#endif /* NOSPL */
"" };
#ifndef NOXFER
static char *hmxxfast[] = {
"FAST, CAUTIOUS, and ROBUST are predefined macros that set several",
"file-transfer parameters at once to achieve the desired file-transfer goal.",
"FAST chooses a large packet size, a large window size, and a fair amount of",
"control-character unprefixing at the risk of possible failure on some",
"connections. FAST is the default tuning in C-Kermit 7.0 and later. In case",
"FAST file transfers fail for you on a particular connection, try CAUTIOUS.",
"If that fails too, try ROBUST. You can also change the definitions of each",
"macro with the DEFINE command. To see the current definitions, type",
""show macro fast", "show macro cautious", or "show macro robust".",
""
};
#endif /* NOXFER */
#ifdef VMS
static char * hmxxpurge[] = {
"Syntax: PURGE [ switches ] [ filespec ]",
" Runs the DCL PURGE command. Switches and filespec are not parsed or",
" verified by Kermit, but passed directly to DCL.",
""
};
#else
#ifdef CKPURGE
static char * hmxxpurge[] = {
"Syntax: PURGE [ switches ] [ filespec ]",
" Deletes backup files; that is, files whose names end in ".~n~", where",
" n is a number. PURGE by itself deletes all backup files in the current",
" directory. Switches:",
" ",
"/AFTER:date-time",
#ifdef VMS
" Specifies that only those files created after the given date-time are",
#else
" Specifies that only those files modified after the given date-time are",
#endif /* VMS */
" to be purged. HELP DATE for info about date-time formats.",
" ",
"/BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified before the given date-time",
#else
" Specifies that only those files modified before the given date-time",
#endif /* VMS */
" are to be purged.",
" ",
"/NOT-AFTER:date-time",
#ifdef VMS
" Specifies that only those files modified at or before the given date-time",
#else
" Specifies that only those files modified at or before the given date-time",
#endif /* VMS */
" are to be purged.",
" ",
"/NOT-BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified at or after the given date-time",
#else
" Specifies that only those files modified at or after the given date-time",
#endif /* VMS */
" are to be purged.",
" ",
"/LARGER-THAN:number",
" Specifies that only those files longer than the given number of bytes are",
" to be purged.",
" ",
"/SMALLER-THAN:number",
" Specifies that only those files smaller than the given number of bytes are",
" to be sent.",
" ",
"/EXCEPT:pattern",
" Specifies that any files whose names match the pattern, which can be a",
" regular filename or may contain wildcards, are not to be purged. To",
" specify multiple patterns (up to 8), use outer braces around the group",
" and inner braces around each pattern:",
" ",
" /EXCEPT:{{pattern1}{pattern2}...}",
" ",
#ifdef UNIXOROSK
"/DOTFILES",
" Include (purge) files whose names begin with ".".",
" ",
"/NODOTFILES",
" Skip (don't purge) files whose names begin with ".".",
" ",
#endif /* UNIXOROSK */
#ifdef RECURSIVE
"/RECURSIVE",
" Descends through the current or specified directory tree.",
" ",
#endif /* RECURSIVE */
"/KEEP:n",
" Retain the 'n' most recent (highest-numbered) backup files for each file.",
" By default, none are kept. If /KEEP is given without a number, 1 is used.",
" ",
"/LIST",
" Display each file as it is processed and say whether it is purged or kept.",
" Synonyms: /LOG, /VERBOSE.",
" ",
"/NOLIST",
" The PURGE command should operate silently (default).",
" Synonyms: /NOLOG, /QUIET.",
" ",
"/HEADING",
" Print heading and summary information.",
" ",
"/NOHEADING",
" Don't print heading and summary information.",
" ",
"/PAGE",
" When /LIST is in effect, pause at the end of each screenful, even if",
" COMMAND MORE-PROMPTING is OFF.",
" ",
"/NOPAGE",
" Don't pause, even if COMMAND MORE-PROMPTING is ON.",
" ",
"/ASK",
" Interactively ask permission to delete each backup file.",
" ",
"/NOASK",
" Purge backup files without asking permission.",
" ",
"/SIMULATE",
" Inhibits the actual deletion of files; use to preview which files would",
" actually be deleted. Implies /LIST.",
" ",
"Use SET OPTIONS PURGE [ switches ] to change defaults; use SHOW OPTIONS to",
"display customized defaults. Also see HELP DELETE, HELP WILDCARD.",
""
};
#endif /* CKPURGE */
#endif /* VMS */
static char *hmxxclo[] = {
"Syntax: CLOSE [ item ]",
" Close the indicated item. The default item is CONNECTION, which is the",
" current SET LINE or SET HOST connection. The other items are:",
" ",
#ifdef CKLOGDIAL
" CX-LOG (connection log, opened with LOG CX)",
#endif /* CKLOGDIAL */
#ifndef NOLOCAL
" SESSION-LOG (opened with LOG SESSION)",
#endif /* NOLOCAL */
#ifdef TLOG
" TRANSACTION-LOG (opened with LOG TRANSACTIONS)",
#endif /* TLOG */
" PACKET-LOG (opened with LOG PACKETS)",
#ifdef DEBUG
" DEBUG-LOG (opened with LOG DEBUG)",
#endif /* DEBUG */
#ifndef NOSPL
" READ-FILE (opened with OPEN READ)",
" WRITE-FILE (opened with OPEN WRITE or OPEN APPEND)",
#endif /* NOSPL */
" ",
"Type HELP LOG and HELP OPEN for further info.", "" };
#ifdef CK_MINPUT
static char *hmxxminp[] = {
"Syntax: MINPUT n [ string1 [ string2 [ ... ] ] ]",
"Example: MINPUT 5 Login: {Username: } {NO CARRIER} BUSY RING",
" For use in script programs. Waits up to n seconds for any one of the",
" strings to arrive on the communication device. If no strings are given,",
" the command waits for any character at all to arrive. Strings are",
" separated by spaces; use { braces } for grouping. If any of the strings",
" is encountered within the timeout interval, the command succeeds and the",
" \v(minput) variable is set to the number of the string that was matched:",
" 1, 2, 3, etc. If none of the strings arrives, the command times out,",
" fails, and \v(minput) is set to 0.",
" ",
"Also see: INPUT, REINPUT, SET INPUT.",
"" };
#endif /* CK_MINPUT */
#ifndef NOLOCAL
static char *hmxxcon[] = {
"Syntax: CONNECT (or C, or CQ) [ switches ]",
" Connect to a remote computer via the serial communications device given in",
#ifdef OS2
" the most recent SET PORT command, or to the network host named in the most",
#else
" the most recent SET LINE command, or to the network host named in the most",
#endif /* OS2 */
" recent SET HOST command. Type the escape character followed by C to get",
" back to the C-Kermit prompt, or followed by ? for a list of CONNECT-mode",
#ifdef OS2
" escape commands. You can also assign the \Kexit verb to the key or",
" key-combination of your choice; by default it is assigned to Alt-x.",
#else
" escape commands.",
" ",
"Include the /QUIETLY switch to suppress the informational message that",
"tells you how to escape back, etc. CQ is a synonym for CONNECT /QUIETLY.",
#endif /* OS2 */
" ",
"Other switches include:",
#ifdef CK_TRIGGER
" ",
"/TRIGGER:string",
" One or more strings to look for that will cause automatic return to",
" command mode. To specify one string, just put it right after the",
" colon, e.g. "/TRIGGER:Goodbye". If the string contains any spaces, you",
" must enclose it in braces, e.g. "/TRIGGER:{READY TO SEND...}". To",
" specify more than one trigger, use the following format:",
" ",
" /TRIGGER:{{string1}{string2}...{stringn}}",
" ",
" Upon return from CONNECT mode, the variable \v(trigger) is set to the",
" trigger string, if any, that was actually encountered. This value, like",
" all other CONNECT switches applies only to the CONNECT command with which",
" it is given, and overrides (temporarily) any global SET TERMINAL TRIGGER",
" string that might be in effect.",
#endif /* CK_TRIGGER */
#ifdef OS2
" ",
"/IDLE-LIMIT:number",
" The number of seconds of idle time, after which Kermit returns",
" automatically to command mode; default 0 (no limit).",
" ",
"/IDLE-INTERVAL:number",
" The number of seconds of idle time, after which Kermit automatically",
" transmits the idle string.",
" ",
"/IDLE-STRING:string",
" The string to transmit whenever the idle interval has passed.",
" ",
"/TIME-LIMIT:number",
" The maximum number of seconds for which the CONNECT session may last.",
" The default is 0 (no limit). If a nonzero number is given, Kermit returns",
" automatically to command mode after this many seconds.",
#endif /* OS2 */
"" };
#endif /* NOLOCAL */
static char *hmxxmget[] = {
"Syntax: MGET [ switches... ] remote-filespec [ remote-filespec ... ]",
" ",
"Just like GET (q.v.) except allows a list of remote file specifications,",
"separated by spaces.",
""
};
static char *hmxxget[] = {
"Syntax: GET [ switches... ] remote-filespec [ as-name ]",
" Tells the other Kermit, which must be in (or support autoswitching into)",
" server mode, to send the named file or files. If the remote-filespec or",
" the as-name contain spaces, they must be enclosed in braces. If as-name",
" is the name of an existing local directory, incoming files are placed in",
" that directory; if it is the name of directory that does not exist, Kermit",
" tries to create it. Optional switches include:",
" ",
"/AS-NAME:text",
" Specifies "text" as the name to store the incoming file under, or",
" directory to store it in. You can also specify the as-name as the second",
" filename on the GET command line.",
" ",
"/BINARY",
" Performs this transfer in binary mode without affecting the global",
" transfer mode.",
" ",
"/COMMAND",
" Receives the file into the standard input of a command, rather than saving",
" it on disk. The /AS-NAME or the second "filename" on the GET command",
" line is interpreted as the name of a command.",
" ",
"/DELETE",
" Asks the other Kermit to delete the file (or each file in the group)",
" after it has been transferred successfully.",
" ",
"/EXCEPT:pattern",
" Specifies that any files whose names match the pattern, which can be a",
" regular filename, or may contain "*" and/or "?" metacharacters,",
" are to be refused. To specify multiple patterns (up to 8), use outer",
" braces around the group, and inner braces around each pattern:",
" ",
" /EXCEPT:{{pattern1}{pattern2}...}",
" ",
"/FILENAMES:{CONVERTED,LITERAL}",
" Overrides the global SET FILE NAMES setting for this transfer only.",
" ",
"/FILTER:command",
" Causes the incoming file to passed through the given command (standard",
" input/output filter) before being written to disk.",
" ",
#ifdef VMS
"/IMAGE",
" Transfer in image mode.",
" ",
#endif /* VMS */
#ifdef CK_LABELED
"/LABELED",
" VMS and OS/2 only: Specifies labeled transfer mode.",
" ",
#endif /* CK_LABELED */
"/MOVE-TO:directory-name",
" Specifies that each file that arrives should be moved to the specified",
" directory after, and only if, it has been received successfully.",
" ",
"/PATHNAMES:{OFF,ABSOLUTE,RELATIVE,AUTO}",
" Overrides the global SET RECEIVE PATHNAMES setting for this transfer.",
" ",
"/QUIET",
" When sending in local mode, this suppresses the file-transfer display.",
" ",
"/RECOVER",
" Used to recover from a previously interrupted transfer; GET /RECOVER",
" is equivalent REGET. Works only in binary mode.",
" ",
"/RECURSIVE",
" Tells the server to descend through the directory tree when locating",
" the files to be sent.",
" ",
"/RENAME-TO:string",
" Specifies that each file that arrives should be renamed as specified",
" after, and only if, it has been received successfully. The string should",
" normally contain variables like \v(filename) or \v(filenum).",
" ",
"/TEXT",
" Performs this transfer in text mode without affecting the global",
" transfer mode.",
" ",
"Also see HELP MGET, HELP SEND, HELP RECEIVE, HELP SERVER, HELP REMOTE.",
""};
static char *hmxxlg[] = {
"Syntax: LOG (or L) filename [ { NEW, APPEND } ]",
" ",
"Record information in a log file:",
" ",
#ifdef CKLOGDIAL
"CX",
" Connections made with SET LINE, SET PORT, SET HOST, DIAL, TELNET, etc.",
" The default filename is CX.LOG in your home directory and APPEND is the",
" default mode for opening.",
" ",
#endif /* CKLOGDIAL */
#ifdef DEBUG
"DEBUG",
" Debugging information, to help track down bugs in the C-Kermit program.",
" The default log name is debug.log in current directory.",
" ",
#endif /* DEBUG */
"PACKETS",
" Kermit packets, to help with protocol problems. The default filename is",
" packet.log in current directory.",
" ",
#ifndef NOLOCAL
"SESSION",
" Records your CONNECT session (default: session.log in current directory).",
" ",
#endif /* NOLOCAL */
#ifdef TLOG
"TRANSACTIONS",
" Names and statistics about files transferred (default: transact.log in",
" current directory; see HELP SET TRANSACTION-LOG for transaction-log format",
" options.)",
" ",
#endif /* TLOG */
"If you include the APPEND keyword after the filename, the existing log file,",
"if any, is appended to; otherwise a new file is created (except APPEND is",
"the default for the connection log). Use CLOSE <keyword> to stop logging.",
#ifdef OS2ORUNIX
" ",
"Note: The filename can also be a pipe, e.g.:",
" ",
" log transactions |lpr",
" log debug {| grep "^TELNET" > debug.log}",
" ",
"Braces are required if the pipeline or filename contains spaces.",
#endif /* OS2ORUNIX */
"" };
#ifndef NOSCRIPT
static char *hmxxlogi[] = { "
Syntax: SCRIPT text",
" A limited and cryptic "login assistant", carried over from old C-Kermit",
" releases for comptability, but not recommended for use. Instead, please",
" use the full script programming language described in chapters 17-19 of",
" "Using C-Kermit".",
" ",
" Login to a remote system using the text provided. The login script",
" is intended to operate similarly to UNIX uucp "L.sys" entries.",
" A login script is a sequence of the form:",
" ",
" expect send [expect send] . . .",
" ",
" where 'expect' is a prompt or message to be issued by the remote site, and",
" 'send' is the names, numbers, etc, to return. The send may also be the",
" keyword EOT to send Control-D, or BREAK (or \\b) to send a break signal.",
" Letters in send may be prefixed by ~ to send special characters:",
" ",
" ~b backspace, ~s space, ~q '?', ~n linefeed, ~r return, ~c don't",
" append a return, and ~o[o[o]] for octal of a character. As with some",
" UUCP systems, sent strings are followed by ~r unless they end with ~c.",
" ",
" Only the last 7 characters in each expect are matched. A null expect,",
" e.g. ~0 or two adjacent dashes, causes a short delay. If you expect",
" that a sequence might not arrive, as with uucp, conditional sequences",
" may be expressed in the form:",
" ",
" -send-expect[-send-expect[...]]",
" ",
" where dashed sequences are followed as long as previous expects fail.",
"" };
#endif /* NOSCRIPT */
#ifndef NOFRILLS
static char * hmxxtyp[] = {
"Syntax: TYPE [ switches... ] file",
" Displays a file on the screen. Pauses automatically at end of each",
" screenful if COMMAND MORE-PROMPTING is ON. Optional switches:",
" ",
" /PAGE",
" Pause at the end of each screenful even if COMMAND MORE-PROMPTING OFF.",
" Synonym: /MORE",
" /NOPAGE",
" Don't pause at the end of each screen even if COMMAND MORE-PROMPTING ON."
,
" /HEAD:n",
" Only type the first 'n' lines of the file.",
" /TAIL:n",
" Only type the last 'n' lines of the file.",
" /MATCH:pattern",
" Only type lines that match the given pattern. HELP WILDCARDS for info",
" info about patterns. /HEAD and /TAIL apply after /MATCH.",
" /PREFIX:string",
" Print the given string at the beginning of each line.",
" /WIDTH:number",
" Truncate each line at the given column number before printing.",
" /COUNT",
" Count lines (and matches) and print the count(s) but not the lines.",
" ",
"You can use SET OPTIONS TYPE to set the defaults for /PAGE or /NOPAGE and",
"/WIDTH. Use SHOW OPTIONS to see current TYPE options.",
""
};
static char * hmxxcle[] = {
"Syntax: CLEAR [ item-name ]",
" ",
"Clears the named item. If no item is named, DEVICE-AND-INPUT is assumed.",
" ",
" ALARM Clears any pending alarm (see SET ALARM).",
#ifdef CK_APC
" APC-STATUS Clears Application Program Command status.",
#endif /* CK_APC */
#ifdef PATTERNS
" BINARY-PATTERNS Clears the file binary-patterns list.",
#endif /* PATTERNS */
#ifdef OS2
" COMMAND-SCREEN Clears the current command screen.",
#endif /* OS2 */
" DEVICE Clears the current port or network input buffer.",
" DEVICE-AND-INPUT Clears both the device and the INPUT buffer.",
" DIAL-STATUS Clears the \v(dialstatus) variable.",
"
INPUT Clears the INPUT command buffer and the \v(input) variable.",
#ifdef OS2
"
SCROLLBACK empties the scrollback buffer including the current screen.",
#endif /* OS2 */
" SEND-LIST Clears the current SEND list (see ADD).",
#ifdef OS2
"
TERMINAL-SCREEN Clears the current screen a places it into the scrollback.",
" buffer.",
#endif /* OS2 */
#ifdef PATTERNS
" TEXT-PATTERNS Clears the file text-patterns list.",
#endif /* PATTERNS */
""};
#endif /* NOFRILLS */
static char * hmxxdate[] = {
"Syntax: DATE [ date-time ]",
" Prints the current date and time in standard format: yyyymmdd_hh:mm:ss.",
" If a date-time is given, converts it to standard format. Various date-time"
," formats are acceptable. The rules for the date-time are:",
" ",
" . The date, if given, must precede the time.",
" . The year must be four digits.",
" . If the year comes first, the second field is the month.",
" . The day, month, and year may be separated by spaces, /, -, or underscore."
," . The date and time may be separated by spaces or underscore.",
" . The month may be numeric (1 = January) or spelled out or abbreviated in",
" English.",
" . The time may be in 24-hour format or 12-hour format.",
" . If the hour is 12 or less, AM is assumed unless AM or PM is included.",
" . If the date is omitted but a time is given, the current date is assumed.",
" . If the time is given but date omitted, 00:00:00 is assumed.",
" . If both the date and time are omitted, the current date and time are",
" assumed.",
" ",
" The following shortcuts can also be used:",
" ",
" TODAY",
" Today's date, optionally followed by a time; 00:00:00 if no time given.",
" ",
" YESTERDAY",
" Yesterday's date, optionally followed by a time (default 00:00:00).",
" ",
" TOMORROW",
" Tomorrows's date, optionally followed by a time (default 00:00:00).",
" ",
" + <number> <timeunits>",
" A date in the future relative to the current date; <timeunits> may be DAYS",
" WEEKS, MONTHS, or YEARS. Optionally followed by a time (default 00:00:00)."
,
" Examples: +3days, +7weeks.",
" ",
" - <number> <timeunits>",
" A date in the past relative to the current date, optionally followed by a",
" time (default 00:00:00). Examples: -1year, -37months.",
" ",
"All the formats shown above are acceptable as arguments to date-time switches"
,
"such as /AFTER: or /BEFORE, and to functions such as \fcvtdate() that take",
"date-time strings as arguments.",
""
};
#ifndef NOXFER
static char * hmxxsen[] = {
"Syntax: SEND (or S) [ switches...] [ filespec [ as-name ] ]",
" Sends the file or files specified by filespec. If the filespec is omitted",
" the SEND-LIST is used (HELP ADD for more info). The filespec may contain",
" wildcard characters. An 'as-name' may be given to specify the name(s)",
" the files(s) are sent under; if the as-name is omitted, each file is",
" sent under its own name. Also see HELP MSEND, HELP WILDCARD.",
" Optional switches include:",
" ",
#ifndef NOSPL
"/ARRAY:<arrayname>",
" Specifies that the data to be sent comes from the given array, such as",
" \&a[]. A range may be specified, e.g. SEND /ARRAY:&a[100:199]. Leave",
" the brackets empty or omit them altogether to send the whole 1-based array."
,
" Include /TEXT to have Kermit supply a line terminator at the end of each",
" array element (and translate character sets if character-set translations",
" are set up), or /BINARY to treat the array as one long string of characters"
,
" to be sent as-is. If an as-name is not specified, the array is sent with",
" the name _ARRAY_X_, where "X" is replaced by actual array letter.",
" ",
#endif /* NOSPL */
"/AS-NAME:<text>",
" Specifies <text> as the name to send the file under instead of its real",
" name. This is equivalent to giving an as-name after the filespec.",
" ",
"/BINARY",
" Performs this transfer in binary mode without affecting the global",
" transfer mode.",
" ",
"/TEXT",
" Performs this transfer in text mode without affecting the global",
" transfer mode.",
" ",
"/NOBACKUP",
" Skip (don't send) Kermit or EMACS backup files (files with names that",
" end with .~n~, where n is a number).",
" ",
#ifdef UNIXOROSK
"/DOTFILES",
" Include (send) files whose names begin with ".".",
" ",
"/NODOTFILES",
" Don't send files whose names begin with ".".",
" ",
#endif /* UNIXOROSK */
#ifdef VMS
"/IMAGE",
" Performs this transfer in image mode without affecting the global",
" transfer mode.",
" ",
#endif /* VMS */
#ifdef CK_LABELED
"/LABELED",
" Performs this transfer in labeled mode without affecting the global",
" transfer mode.",
" ",
#endif /* CK_LABELED */
"/COMMAND",
" Sends the output from a command, rather than the contents of a file.",
" The first "filename" on the SEND command line is interpreted as the name",
" of a command; the second (if any) is the as-name.",
" ",
"/FILENAMES:{CONVERTED,LITERAL}",
" Overrides the global SET FILE NAMES setting for this transfer only.",
" ",
"/PATHNAMES:{OFF,ABSOLUTE,RELATIVE}",
" Overrides the global SET SEND PATHNAMES setting for this transfer.",
" ",
"/FILTER:command",
" Specifies a command
(standard input/output filter) to pass the file through",
" before sending it.",
" ",
"/DELETE",
" Deletes the file (or each file in the group) after it has been sent",
" successfully (applies only to real files).",
" ",
"/QUIET",
" When sending in local mode, this suppresses the file-transfer display.",
" ",
"/RECOVER",
" Used to recover from a previously interrupted transfer; SEND /RECOVER",
" is equivalent RESEND (use in binary mode only).",
" ",
"/RECURSIVE",
" Tells C-Kermit to look not only in the given or current directory for",
" files that match the filespec, but also in all its subdirectories, and",
" all their subdirectories, etc.",
" ",
"/RENAME-TO:name",
" Tells C-Kermit to rename each source file that is sent successfully to",
" the given name (usually you should include \v(filename) in the new name,",
" which is replaced by the original filename.",
" ",
"/MOVE-TO:directory",
" Tells C-Kermit to move each source file that is sent successfully to",
" the given directory.",
" ",
"/STARTING:number",
" Starts sending the file from the given byte position.",
" SEND /STARTING:n filename is equivalent to PSEND filename n.",
" ",
"/SUBJECT:text",
" Specifies the subject of an email message, to be used with /MAIL. If the",
" text contains spaces, it must be enclosed in braces.",
" ",
"/MAIL:address",
" Sends the file as e-mail to the given address; use with /SUBJECT:.",
" ",
"/PRINT:options",
" Sends the file to be printed, with optional options for the printer.",
" ",
#ifdef CK_XYZ
"/PROTOCOL:name",
" Uses the given protocol to send the file (Kermit, Zmodem, etc) for this",
" transfer without changing global protocol.",
" ",
#endif /* CK_XYZ */
"/AFTER:date-time",
#ifdef VMS
" Specifies that only those files created after the given date-time are",
#else
" Specifies that only those files modified after the given date-time are",
#endif /* VMS */
" to be sent. HELP DATE for info about date-time formats.",
" ",
"/BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified before the given date-time",
#else
" Specifies that only those files modified before the given date-time",
#endif /* VMS */
" are to be sent.",
" ",
"/NOT-AFTER:date-time",
#ifdef VMS
" Specifies that only those files modified at or before the given date-time",
#else
" Specifies that only those files modified at or before the given date-time",
#endif /* VMS */
" are to be sent.",
" ",
"/NOT-BEFORE:date-time",
#ifdef VMS
" Specifies that only those files modified at or after the given date-time",
#else
" Specifies that only those files modified at or after the given date-time",
#endif /* VMS */
" are to be sent.",
" ",
"/LARGER-THAN:number",
" Specifies that only those files longer than the given number of bytes are",
" to be sent.",
" ",
"/SMALLER-THAN:number",
" Specifies that only those files smaller than the given number of bytes are",
" to be sent.",
" ",
"/EXCEPT:pattern",
" Specifies that any files whose names match the pattern, which can be a",
" regular filename, or may contain "*" and/or "?" metacharacters,",
" are not to be sent. To specify multiple patterns (up to 8), use outer",
" braces around the group, and inner braces around each pattern:",
" ",
" /EXCEPT:{{pattern1}{pattern2}...}",
" ",
"/LISTFILE:filename",
" Specifies the name of a file that contains the list of names of files",
" that are to be sent. The filenames should be listed one name per line",
" in this file (but a name can contain wildcards).",
" ",
"Also see HELP RECEIVE, HELP GET, HELP SERVER, HELP REMOTE.",
""};
static char *hmxxrc[] = {
"Syntax: RECEIVE (or R) [ switches... ] [ as-name ]",
" Wait for a file to arrive from the other Kermit, which must be given a",
" SEND command. If the optional as-name is given, the incoming file or",
" files are stored under that name, otherwise it will be stored under",
#ifndef CK_TMPDIR
" the name it arrives with.",
#else
#ifdef OS2
" the name it arrives with. If the filespec denotes a disk and/or",
" directory, the incoming file or files will be stored there.",
#else
" the name it arrives with. If the filespec denotes a directory, the",
" incoming file or files will be placed in that directory.",
#endif /* OS2 */
#endif /* CK_TMPDIR */
" ",
"Optional switches include:",
" ",
"/AS-NAME:text",
" Specifies "text" as the name to store the incoming file under.",
" You can also specify the as-name as a filename on the command line.",
" ",
"/BINARY",
" Skips text-mode conversions unless the incoming file arrives with binary",
" attribute",
" ",
"/COMMAND",
" Receives the file into the standard input of a command, rather than saving",
" it on disk. The /AS-NAME or the "filename" on the RECEIVE command line",
" is interpreted as the name of a command.",
" ",
"/EXCEPT:pattern",
" Specifies that any files whose names match the pattern, which can be a",
" regular filename, or may contain "*" and/or "?" metacharacters,",
" are to be refused. To specify multiple patterns (up to 8), use outer",
" braces around the group, and inner braces around each pattern:",
" ",
" /EXCEPT:{{pattern1}{pattern2}...}",
" ",
"/FILENAMES:{CONVERTED,LITERAL}",
" Overrides the global SET FILE NAMES setting for this transfer only.",
" ",
"/FILTER:command",
" Causes the incoming file to passed through the given command (standard",
" input/output filter) before being written to disk.",
" ",
#ifdef VMS
"/IMAGE",
" Receives the file in image mode.",
" ",
#endif /* VMS */
#ifdef CK_LABELED
"/LABELED",
" Specifies labeled transfer mode.",
" ",
#endif /* CK_LABELED */
"/MOVE-TO:directory-name",
" Specifies that each file that arrives should be moved to the specified",
" directory after, and only if, it has been received successfully.",
" ",
"/PATHNAMES:{OFF,ABSOLUTE,RELATIVE,AUTO}",
" Overrides the global SET RECEIVE PATHNAMES setting for this transfer.",
" ",
"/PROTOCOL:name",
" Use the given protocol to receive the incoming file(s).",
" ",
"/QUIET",
" When sending in local mode, this suppresses the file-transfer display.",
" ",
"/RECURSIVE",
" Equivalent to /PATHNAMES:RELATIVE.",
" ",
"/RENAME-TO:string",
" Specifies that each file that arrives should be renamed as specified",
" after, and only if, it has been received successfully. The string should",
" normally contain variables like \v(filename) or \v(filenum).",
" ",
"/TEXT",
" Forces text-mode conversions unless the incoming file has the binary",
" attribute",
" ",
"Also see HELP SEND, HELP GET, HELP SERVER, HELP REMOTE.",
"" };
#ifndef NORESEND
static char *hmxxrsen = "
Syntax: RESEND filespec [name]nn
Resend the file or files, whose previous transfer was interrupted.n
Picks up from where previous transfer left off, IF the receiver was toldn
to SET FILE INCOMPLETE KEEP. Only works for binary-mode transfers.n
Requires the other Kermit to have RESEND capability.";
static char *hmxxrget = "
Syntax: REGET filespecnn
Ask a server to RESEND a file to C-Kermit.";
static char *hmxxpsen = "
Syntax: PSEND filespec position [name]nn
Just like SEND, except sends the file starting at the given byte position.";
#endif /* NORESEND */
#ifndef NOMSEND
static char *hmxxmse[] = {
"Syntax: MSEND [ switches... ] filespec [ filespec [ ... ] ]",
" Sends the files specified by the filespecs. One or more filespecs may be",
" listed, separated by spaces. Any or all filespecs may contain wildcards",
" and they may be in different directories. Alternative names cannot be",
" given. Switches include /BINARY /DELETE /MAIL /PROTOCOL /QUIET /RECOVER",
" /TEXT; see HELP SEND for descriptions.",
""
};
#endif /* NOMSEND */
static char *hmxxadd[] = {
#ifndef NOMSEND
"ADD SEND-LIST filespec [ <mode> [ <as-name> ] ]",
" Adds the specified file or files to the current SEND list. Use SHOW",
" SEND-LIST and CLEAR SEND-LIST to display and clear the list; use SEND",
" by itself to send the files from it.",
" ",
#endif /* NOMSEND */
#ifdef PATTERNS
"ADD BINARY-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Adds the pattern(s), if any, to the SET FILE BINARY-PATTERNS list.",
" ",
"ADD TEXT-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Adds the pattern(s), if any, to the SET FILE TEXT-PATTERNS list.",
" Use SHOW PATTERNS to see the lists. See HELP SET FILE for further info.",
#endif /* PATTERNS */
""};
static char *hmxxremv[] = {
#ifdef PATTERNS
"REMOVE BINARY-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Removes the pattern(s), if any, from the SET FILE BINARY-PATTERNS list",
" ",
"REMOVE TEXT-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Removes the given patterns from the SET FILE TEXT-PATTERNS list.",
" Use SHOW PATTERNS to see the lists. See HELP SET FILE for further info.",
#endif /* PATTERNS */
""};
#endif /* NOXFER */
#ifndef NOSERVER
static char *hmxxser = "Syntax: SERVERn
Enter server mode on the current connection. All further commandsn
are taken in packet form from the other Kermit program. Use FINISH,n
BYE, or REMOTE EXIT to get C-Kermit out of server mode.";
#endif /* NOSERVER */
static char *hmhset[] = {
" The SET command establishes communication, file, scripting, or other",
" parameters. The SHOW command can be used to display the values of",
" SET parameters. Help is available for each individual parameter;",
" type HELP SET ? to see what's available.",
"" };
#ifndef NOSETKEY
static char *hmhskey[] = {
"Syntax: SET KEY k text",
"Or: SET KEY CLEAR",
" Configure the key whose "scan code" is k to send the given text when",
" pressed during CONNECT mode. SET KEY CLEAR restores all the default",
" key mappings. If there is no text, the default key binding is restored",
#ifndef NOCSETS
" for the key k. SET KEY mappings take place before terminal character-set",
" translation.",
#else
" the key k.",
#endif /* NOCSETS */
#ifdef OS2
" ",
" The text may contain "\Kverbs" to denote actions, to stand for DEC",
" keypad, function, or editing keys, etc. For a list of available keyboard",
" verbs, type SHOW KVERBS.",
#endif /* OS2 */
" ",
" To find out the scan code and mapping for a particular key, use the",
" SHOW KEY command.",
""};
#endif /* NOSETKEY */
static char *hmxychkt[] = { "Syntax: SET BLOCK-CHECK type",
" ",
" Type of packet block check to be used for error detection, 1, 2, 3, or",
" BLANK-FREE-2. Type 1 is standard, and catches most errors. Types 2 and 3",
" specify more rigorous checking at the cost of higher overhead. The",
" BLANK-FREE-2 type is the same as Type 2, but is guaranteed to contain no",
" blanks.",
"" };
static char * hmxydeb[] = {
"Syntax: SET DEBUG { SESSION, ON, OFF, TIMESTAMP }",
" ",
"SET DEBUG ON",
#ifdef DEBUG
" Opens a debug log file named debug.log in the current directory.",
" Use LOG DEBUG if you want specify a different log file name or path.",
#else
" (Has no effect in this version of Kermit.)",
#endif /* DEBUG */
" ",
"SET DEBUG OFF",
" Stops debug logging and session debugging.",
" ",
"SET DEBUG SESSION",
#ifndef NOLOCAL
" Displays control and 8-bit characters symbolically during CONNECT mode.",
" Equivalent to SET TERMINAL DEBUG ON.",
#else
" (Has no effect in this version of Kermit.)",
#endif /* NOLOCAL */
" ",
"SET DEBUG TIMESTAMP { ON, OFF }",
" Enables/Disables timestamps on debug log entries.",
"" };
#ifdef CK_SPEED
static char *hmxyqctl[] = {
"Syntax: SET CONTROL-CHARACTER { PREFIXED, UNPREFIXED } { <code>..., ALL }",
" ",
" <code> is the numeric ASCII code for a control character 1-31,127-159,255."
,
" The word "ALL" means all characters in this range.",
" ",
" PREFIXED <code> means the given control character must be converted to a",
" printable character and prefixed, the default for all control characters.",
" ",
" UNPREFIXED <code> means you think it is safe to send the given control",
" character as-is, without a prefix. USE THIS OPTION AT YOUR OWN RISK!",
" ",
" SHOW CONTROL to see current settings. SET CONTROL PREFIXED ALL is",
" recommended for safety. You can include multiple <code> values in one",
" command, separated by spaces.",
"" };
#endif /* CK_SPEED */
#ifndef NODIAL
static char *hxymodm[] = {
"Syntax: SET MODEM <parameter> <value> ...",
" ",
"Note: Many of the SET MODEM parameters are configured automatically when",
"you SET MODEM TYPE, according to the modem's capabilities. SHOW MODEM to",
"see them. Also see HELP DIAL and HELP SET DIAL.",
" ",
"SET MODEM TYPE <name>",
" Tells Kermit which kind of modem you have, so it can issue the appropriate",
" modem-specific commands for configuration, dialing, and hanging up. For a",
" list of the modem types known to Kermit, type "set modem type ?".",
" Use SET MODEM TYPE NONE (the default) for direct serial connections. Use",
" SET MODEM TYPE USER-DEFINED to use a type of modem that is not built in",
" to Kermit, and then user SET MODEM CAPABILITIES, SET MODEM DIAL-COMMAND,",
" and SET MODEM COMMAND to tell Kermit how to configure and control it.",
" ",
#ifdef UNIX
" Give the SET MODEM TYPE command BEFORE the SET LINE command so Kermit can",
" open the communications device in the correct mode for dialing.",
" ",
#endif /* UNIX */
"SET MODEM CAPABILITIES <list>",
" Use this command for changing Kermit's idea of your modem's capabilities,",
" for example, if your modem is supposed to have built-in error correction",
" but in fact does not. Also use this command to define the capabilities",
" of a USER-DEFINED modem. Capabilities are:",
" ",
" AT AT-commands",
" DC data-compression",
" EC error-correction",
" HWFC hardware-flow",
" ITU v25bis-commands",
" SWFC software-flow",
" KS kermit-spoof",
" SB speed-buffering",
" TB Telebit",
" ",
"SET MODEM CARRIER-WATCH { AUTO, ON, OFF }",
" Synonym for SET CARRIER-WATCH (q.v.)",
" ",
"SET MODEM COMPRESSION { ON, OFF }",
" Enables/disables the modem's data compression feature, if any.",
" ",
"SET MODEM DIAL-COMMAND <text>",
" The text replaces Kermit's built-in modem dialing command. It must",
" include '%s' (percent s) as a place-holder for the telephone numbers",
" given in your DIAL commands.",
" ",
"SET MODEM ERROR-CORRECTION { ON, OFF }",
" Enables/disables the modem's error-correction feature, if any.",
" ",
"SET MODEM ESCAPE-CHARACTER number",
" Numeric ASCII value of modem's escape character, e.g. 43 for '+'.",
" For Hayes-compatible modems, Kermit uses three copies, e.g. "+++".",
" ",
"SET MODEM FLOW-CONTROL {AUTO, NONE, RTS/CTS, XON/XOFF}",
" Selects the type of local flow control to be used by the modem.",
" ",
"SET MODEM HANGUP-METHOD { MODEM-COMMAND, RS232-SIGNAL }",
" How hangup operations should be done. MODEM-COMMAND means try to",
" escape back to the modem's command processor and give a modem-specific",
" hangup command. RS232-SIGNAL means turn off the DTR signal.",
" ",
"SET MODEM KERMIT-SPOOF {ON, OFF}",
" If the selected modem type supports the Kermit protocol directly,",
" use this command to turn its Kermit protocol function on or off.",
" ",
"SET MODEM MAXIMUM-SPEED <number>",
" Specify the maximum interface speed for the modem.",
" ",
"SET MODEM NAME <text>",
" Descriptive name for a USER-DEFINED modem.",
" ",
"SET MODEM SPEAKER {ON, OFF}",
" Turns the modem's speaker on or off during dialing.",
" ",
"SET MODEM SPEED-MATCHING {ON, OFF}",
" ON means that C-Kermit changes its serial interface speed to agree with",
" the speed reported by the modem's CONNECT message, if any. OFF means",
" Kermit should not change its interface speed.",
" ",
"SET MODEM VOLUME {LOW, MEDIUM, HIGH}",
" Selects the desired modem speaker volume for when the speaker is ON.",
" ",
"SET MODEM COMMAND commands are used to override built-in modem commands for",
"each modem type, or to fill in commands for the USER-DEFINED modem type.",
"Omitting the optional [ text ] restores the built-in modem-specific command,",
"if any:",
" ",
"SET MODEM COMMAND AUTOANSWER {ON, OFF} [ text ]",
" Modem commands to turn autoanswer on and off.",
" ",
"SET MODEM COMMAND COMPRESSION {ON, OFF} [ text ]",
" Modem commands to turn data compression on and off.",
" ",
"SET MODEM COMMAND ERROR-CORRECTION {ON, OFF} [ text ]",
" Modem commands to turn error correction on and off.",
" ",
"SET MODEM COMMAND HANGUP [ text ]",
" Command that tells the modem to hang up the connection.",
" ",
"SET MODEM COMMAND IGNORE-DIALTONE [ text ]",
" Command that tells the modem not to wait for dialtone before dialing.",
" ",
"SET MODEM COMMAND INIT-STRING [ text ]",
" The 'text' is a replacement for C-Kermit's built-in initialization command",
" for the modem.",
" ",
"SET MODEM COMMAND PREDIAL-INIT [ text ]",
" A second INIT-STRING that is to be sent to the modem just prior to
dialing.",
" ",
"SET MODEM COMMAND HARDWARE-FLOW [ text ]",
" Modem command to enable hardware flow control (RTS/CTS) in the modem.",
" ",
"SET MODEM COMMAND SOFTWARE-FLOW [ text ]",
" Modem command to enable local software flow control (Xon/Xoff) in modem.",
" ",
"SET MODEM COMMAND SPEAKER { ON, OFF } [ text ]",
" Modem command to turn the modem's speaker on or off.",
" ",
"SET MODEM COMMAND NO-FLOW-CONTROL [ text ]",
" Modem command to disable local flow control in the modem.",
" ",
"SET MODEM COMMAND PULSE [ text ]",
" Modem command to select pulse dialing.",
" ",
"SET MODEM COMMAND TONE [ text ]",
" Modem command to select tone dialing.",
" ",
"SET MODEM COMMAND VOLUME { LOW, MEDIUM, HIGH } [ text ]",
" Modem command to set the modem's speaker volume.",
""};
static char *hmxydial[] = {
"The SET DIAL command establishes or changes all parameters related to",
"dialing the telephone. Also see HELP DIAL and HELP SET MODEM. Use SHOW",
"DIAL to display all of the SET DIAL values.",
" ",
"SET DIAL COUNTRY-CODE <number>",
" Tells Kermit the telephonic country-code of the country you are dialing",
" from, so it can tell whether a portable-format phone number from your",
" dialing directory will result in a national or an international call.",
" Examples: 1 for USA, Canada, Puerto Rico, etc; 7 for Russia, 39 for Italy,",
" 351 for Portugal, 47 for Norway, 44 for the UK, 972 for Israel, 81 for",
" Japan, ...",
" ",
" If you have not already set your DIAL INTL-PREFIX and LD-PREFIX, then this",
" command sets default values for them: 011 and 1, respectively, for country",
" code 1; 00 and 0, respectively, for all other country codes. If these are",
" not your true international and long-distance dialing prefixes, then you",
" should follow this command by DIAL INTL-PREFIX and LD-PREFIX to let Kermit",
" know what they really are.",
" ",
"SET DIAL AREA-CODE [ <number> ]",
" Tells Kermit the area or city code that you are dialing from, so it can",
" tell whether a portable-format phone number from the dialing directory is",
" local or long distance. Be careful not to include your long-distance",
" dialing prefix as part of your area code; for example, the area code for",
" central London is 171, not 0171.",
" ",
"SET DIAL CONFIRMATION {ON, OFF}",
" Kermit does various transformations on a telephone number retrieved from",
" the dialing directory prior to dialing (use LOOKUP <name> to see them).",
" In case the result might be wrong, you can use SET DIAL CONFIRM ON to have",
" Kermit ask you if it is OK to dial the number, and if not, to let you type",
" in a replacement.",
" ",
"SET DIAL CONNECT { AUTO, ON, OFF }",
" Whether to CONNECT (enter terminal mode) automatically after successfully",
" dialing. ON means to do this; OFF means not to. AUTO (the default) means",
" do it if the DIAL command was given interactively, but don't do it if the",
" DIAL command was issued from a macro or command file. If you specify ON",
" or AUTO, you may follow this by one of the keywords VERBOSE or QUIET, to",
" indicate whether the verbose 4-line 'Connecting...' message is to be",
" displayed if DIAL succeeds and Kermit goes into CONNECT mode.",
" ",
"SET DIAL CONVERT-DIRECTORY {ASK, ON, OFF}",
" The format of Kermit's dialing directory changed in version 5A(192). This",
" command tells Kermit what to do when it encounters an old-style directory:",
" ASK you whether to convert it, or convert it automatically (ON), or leave",
" it alone (OFF). Old-style directories can still be used without",
" conversion, but the parity and speed fields are ignored.",
" ",
"SET DIAL DIRECTORY [ filename [ filename [ filename [ ... ] ] ] ]",
" The name(s) of your dialing directory file(s). If you do not supply any",
" filenames, the dialing directory feature is disabled and all numbers are",
" dialed literally as given in the DIAL command. If you supply more than",
" one directory, all of them are searched.",
" ",
"SET DIAL SORT {ON, OFF}",
" When multiple entries are obtained from your dialing directory, they are",
" sorted in "cheapest-first" order. If this does not produce the desired",
" effect, SET DIAL SORT OFF to disable sorting, and the numbers will be",
" dialed in the order in which they were found.",
" ",
"SET DIAL DISPLAY {ON, OFF}",
" Whether to display dialing progress on the screen; default is OFF.",
" ",
"SET DIAL HANGUP {ON, OFF}",
" Whether to hang up the phone prior to dialing; default is ON.",
" ",
"SET DIAL IGNORE-DIALTONE {ON, OFF}",
" Whether to ignore dialtone when dialing; default is OFF.",
" ",
#ifndef NOSPL
"SET DIAL MACRO [ name ]",
" Specify the name of a macro to execute on every phone number dialed, just",
" prior to dialing it, in order to perform any last-minute alterations.",
" ",
#endif /* NOSPL */
"SET DIAL METHOD {AUTO, DEFAULT, TONE, PULSE}",
" Whether to use the modem's DEFAULT dialing method, or to force TONE or",
" PULSE dialing. AUTO (the default) means to choose tone or pulse dialing",
" based on the country code. (Also see SET DIAL TONE-COUNTRIES and SET DIAL",
" PULSE-COUNTRIES.)",
" ",
"SET DIAL PACING number",
" How many milliseconds to pause between sending each character to the modem",
" dialer. The default is -1, meaning to use the number from the built-in",
" modem database.",
" ",
"SET DIAL PULSE-COUNTRIES [ cc [ cc [ ... ] ] ]",
" Sets the list of countries in which pulse dialing is required. Each cc",
" is a country code.",
" ",
"SET DIAL TEST { ON, OFF }",
" OFF for normal dialing. Set to ON to test dialing procedures without",
" actually dialing.",
" ",
"SET DIAL TONE-COUNTRIES [ cc [ cc [ ... ] ] ]",
" Sets the list of countries in which tone dialing is available. Each cc",
" is a country code.",
" ",
"SET DIAL TIMEOUT number",
" How many seconds to wait for a dialed call to complete. Use this command",
" to override the DIAL command's automatic timeout calculation. A value",
" of 0 turns off this feature and returns to Kermit's automatic dial",
" timeout calculation.",
" ",
"SET DIAL RESTRICT { INTERNATIONAL, LOCAL, LONG-DISTANCE, NONE }",
" Prevents placing calls of the type indicated, or greater. For example",
" SET DIAL RESTRICT LONG prevents placing of long-distance and international",
" calls. If this command is not given, there are no restrictions. Useful",
" when dialing a list of numbers fetched from a dialing directory.",
" ",
"SET DIAL RETRIES <number>",
" How many times to redial each number if the dialing result is busy or no",
" no answer, until the call is succesfully answered. The default is 0",
" because automatic redialing is illegal in some countries.",
" ",
"SET DIAL INTERVAL <number>",
" How many seconds to pause between automatic redial attempts; default 10.",
" ",
"The following commands apply to all phone numbers, whether given literally",
"or found in the dialing directory:",
" ",
"SET DIAL PREFIX [ text ]",
" Establish a prefix to be applied to all phone numbers that are dialed,",
" for example to disable call waiting.",
" ",
"SET DIAL SUFFIX [ text ]",
" Establish a suffix to be added after all phone numbers that are dialed.",
" ",
"The following commands apply only to portable-format numbers obtained from",
"the dialing directory; i.e. numbers that start with a "+" sign and",
"country code, followed by area code in parentheses, followed by the phone",
"number.",
" ",
"SET DIAL LC-AREA-CODES [ <list> ]",
" Species a list of area codes to which dialing is local, i.e. does not",
" require the LD-PREFIX. Up to 32 area codes may be listed, separated by",
" spaces. Any area codes in this list will be included in the final dial",
" string so do not include your own area code if it should not be dialed.",
" ",
"SET DIAL LC-PREFIX [ <text> ]",
" Specifies a prefix to be applied to local calls made from portable dialing",
" directory entries. Normally no prefix is used for local calls.",
" ",
"SET DIAL LC-SUFFIX [ <text> ]",
" Specifies a suffix to be applied to local calls made from portable dialing",
" directory entries. Normally no suffix is used for local calls.",
" ",
"SET DIAL LD-PREFIX [ <text> ]",
" Your long-distance dialing prefix, to be used with portable dialing",
" directory entries that result in long-distance calls.",
" ",
"SET DIAL LD-SUFFIX [ <text> ]",
" Long-distance dialing suffix, if any, to be used with portable dialing",
" directory entries that result in long-distance calls. This would normally",
" be used for appending a calling-card number to the phone number.",
" ",
"SET DIAL FORCE-LONG-DISTANCE { ON, OFF }",
" Whether to force long-distance dialing for calls that normally would be",
" local. For use (e.g.) in France.",
" ",
"SET DIAL TOLL-FREE-AREA-CODE [ <number> [ <number> [ ... ] ] ]",
" Tells Kermit the toll-free area code(s) in your country.",
" ",
"SET DIAL TOLL-FREE-PREFIX [ <text> ]",
" You toll-free dialing prefix, in case it is different from your long-",
" distance dialing prefix.",
" ",
"SET DIAL INTL-PREFIX <text>",
" Your international dialing prefix, to be used with portable dialing",
" directory entries that result in international calls.",
" ",
"SET DIAL INTL-SUFFIX <text>",
" International dialing suffix, if any, to be used with portable dialing",
" directory entries that result in international calls.",
" ",
"SET DIAL PBX-OUTSIDE-PREFIX <text>",
" Use this to tell Kermit how to get an outside line when dialing from a",
" Private Branch Exchange (PBX).",
" ",
"SET DIAL PBX-EXCHANGE <text> [ <text> [ ... ] ]",
" If PBX-OUTSIDE-PREFIX is set, then you can use this command to tell Kermit",
" the leading digits of one or more local phone numbers that identify it as",
" being on your PBX, so it can make an internal call by deleting those digits"
,
" from the phone number.",
" ",
"SET DIAL PBX-INTERNAL-PREFIX <text>",
" If PBX-EXCHANGE is set, and Kermit determines from it that a call is",
" internal, then this prefix, if any, is added to the number prior to",
"
dialing. Use this if internal calls from your PBX require a special prefix.",
"" };
#endif /* NODIAL */
static char *hmxyflo[] = { "Syntax: SET FLOW [ switch ] value",
" ",
#ifndef NOLOCAL
" Selects the type of flow control to use during file transfer, terminal",
" connection, and script execution.",
#else
" Selects the type of flow control to use during file transfer.",
#endif /* NOLOCAL */
" ",
" Switches let you associate a particular kind of flow control with each",
" kind of connection: /REMOTE, /MODEM, /DIRECT-SERIAL, /TCPIP, etc; type",
" "set flow ?" for a list of available switches. Then whenever you make",
" a connection, the associated flow-control is chosen automatically.",
" The flow-control values are NONE, KEEP, XON/XOFF, and possibly RTS/CTS",
" and some others; again, type "set flow ?" for a list. KEEP tells Kermit",
" not to try to change the current flow-control method for the connection.",
" ",
" If you omit the switch and simply supply a value, this value becomes the",
" current flow control type, overriding any default value that might have",
" been chosen in your most recent SET LINE, SET PORT, or SET HOST, or other",
" connection-establishment command.",
" ",
" Type SHOW FLOW-CONTROL to see the current defaults for each connection type"
,
" as well as the current connection type and flow-control setting. SHOW",
" COMMUNICATIONS also shows the current flow-control setting.",
""};
static char *hmxyf[] = {
"Syntax: SET FILE parameter value",
" ",
"Sets file-related parameters. Use SHOW FILE to view them. Also see SET",
"TRANSFER and SET PROTOCOL.",
" ",
#ifdef VMS
"SET FILE TYPE { TEXT, BINARY, IMAGE, LABELED }",
#else
#ifdef STRATUS
"SET FILE TYPE { TEXT, BINARY, LABELED }",
#else
#ifdef MAC
"SET FILE TYPE { TEXT, BINARY, MACBINARY }",
#else
"SET FILE TYPE { TEXT, BINARY }",
#endif /* STRATUS */
#endif /* MAC */
#endif /* VMS */
" How file contents are to be treated during file transfer in the absence",
" of any other indication. TYPE can be TEXT for conversion of record format",
" and character set, which is usually needed when transferring text files",
" between unlike platforms (such as UNIX and Windows), or BINARY for no",
" conversion if TRANSFER MODE is MANUAL, which is not the default. Use",
" BINARY with TRANSFER MODE MANUAL for executable programs or binary data or",
" whenever you wish to duplicate the original contents of the file, byte for"
,
" byte. In most modern Kermit programs, the file sender informs the receiver"
,
" of the file type automatically. However, when sending files from C-Kermit",
" to an ancient or non-Columbia Kermit implementation, you might need to set",
" the corresponding file type at the receiver as well.",
" ",
#ifdef VMS
" FILE TYPE settings of TEXT and BINARY have no effect when sending files,",
" since VMS C-Kermit determines each file's type automatically from its",
" record format: binary for fixed, text for others. For incoming files,",
" these settings are effective only in the absence of a file-type indication",
" from the sender.",
" ",
" You may include an optional record-format after the word BINARY. This may",
" be FIXED (the default) or UNDEFINED. UNDEFINED is used when you need to",
" receive binary files in binary mode and have them stored with UNDEFINED",
" record format, which is required by certain VMS applications.",
" ",
" Two additional VMS file types are also supported: IMAGE and LABELED.",
" IMAGE means raw block i/o, no interference from RMS, applies to file",
" transmission only, and overrides the normal automatica file type",
" determination. LABELED means to send or interpret RMS attributes",
" with the file.",
" ",
#else
" When TRANSFER MODE is AUTOMATIC (as it is by default), various automatic",
" methods (depending on the platform) are used to determine whether a file",
" is transferred in text or binary mode; these methods (which might include",
" filename pattern matching (see SET FILE PATTERNS below), client/server",
" "kindred-spirit" recognition, or source file record format) supersede",
" the FILE TYPE setting but can, themselves, be superseded by including a",
" /BINARY or /TEXT switch in the SEND, GET, or RECEIVE command.",
" ",
" When TRANSFER MODE is MANUAL, the FILE TYPE setting takes precedence.",
#endif /* VMS */
" ",
#ifndef NOXFER
#ifdef PATTERNS
"SET FILE PATTERNS { ON, OFF, AUTO }",
" ON means to use filename pattern lists to determine whether to send a file",
" in text or binary mode. OFF means to send all files in the prevailing",
" mode. AUTO (the default) is like ON if the other Kermit accepts Attribute",
" packets and like OFF otherwise.",
" ",
"SET FILE BINARY-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Zero or more filename patterns which, if matched, cause a file to be sent",
" in binary mode when FILE PATTERNS are ON. HELP WILDCARDS for a description"
,
" of pattern syntax. SHOW PATTERNS to see the current file pattern lists.",
" ",
"SET FILE TEXT-PATTERNS [ <pattern> [ <pattern> ... ] ]",
" Zero or more filename patterns which, if matched, cause a file to be sent",
" in text mode when FILE PATTERNS is ON; if a file does not match a text or",
" binary pattern, the prevailing SET FILE TYPE is used.",
" ",
#endif /* PATTERNS */
"SET FILE BYTESIZE { 7, 8 }",
" Normally 8. If 7, truncate the 8th bit of all file bytes.",
" ",
#ifndef NOCSETS
"SET FILE CHARACTER-SET name",
" Tells the encoding of the local file, ASCII by default.",
" The names ITALIAN, PORTUGUESE, NORWEGIAN, etc, refer to 7-bit ISO-646",
" national character sets. LATIN1 is the 8-bit ISO 8859-1 Latin Alphabet 1",
" for Western European languages.",
" NEXT is the 8-bit character set of the NeXT workstation.",
" The CPnnn sets are for PCs. MACINTOSH-LATIN is for the Macintosh.",
#ifndef NOLATIN2
" LATIN2 is ISO 8859-2 for Eastern European languages that are written with",
" Roman letters. Mazovia is a PC code page used in Poland.",
#endif /* NOLATIN2 */
#ifdef CYRILLIC
" KOI-CYRILLIC, CYRILLIC-ISO, and CP866 are 8-bit Cyrillic character sets.",
" SHORT-KOI is a 7-bit ASCII coding for Cyrillic. BULGARIA-PC is a PC code",
" page used in Bulgaria",
#endif /* CYRILLIC */
#ifdef HEBREW
" HEBREW-ISO is ISO 8859-8 Latin/Hebrew. CP862 is the Hebrew PC code page.",
" HEBREW-7 is like ASCII with the lowercase letters replaced by Hebrew.",
#endif /* HEBREW */
#ifdef GREEK
" GREEK-ISO is ISO 8859-7 Latin/Greek. CP869 is the Greek PC code page.",
" ELOT-927 is like ASCII with the lowercase letters replaced by Greek.",
#endif /* GREEK */
#ifdef KANJI
" JAPANESE-EUC, JIS7-KANJI, DEC-KANJI, and SHIFT-JIS-KANJI are Japanese",
" Kanji character sets.",
#endif /* KANJI */
#ifdef UNICODE
" UCS-2 is the 2-byte form of the Universal Character Set.",
" UTF-8 is the serialized form of the Universal Character Set.",
#endif /* UNICODE */
" Type SET FILE CHAR ? for a complete list of file character sets.",
" ",
#endif /* NOCSETS */
"SET FILE COLLISION option",
" Tells what to do when a file arrives that has the same name as",
" an existing file. The options are:",
" BACKUP (default) - Rename the old file to a new, unique name and store",
" the incoming file under the name it was sent with.",
" OVERWRITE - Overwrite (replace) the existing file.",
" APPEND - Append the incoming file to the end of the existing file.",
" DISCARD - Refuse and/or discard the incoming file.",
" RENAME - Give the incoming file a unique name.",
" UPDATE - Accept the incoming file only if newer than the existing file.",
" ",
"SET FILE DESTINATION { DISK, PRINTER, SCREEN, NOWHERE }",
" DISK (default): Store incoming files on disk.",
" PRINTER: Send incoming files to SET PRINTER device.",
" SCREEN: Display incoming files on screen (local mode only).",
" NOWHERE: Do not put incoming files anywhere (use for calibration).",
" ",
"SET FILE DISPLAY option",
" Selects the format of the file transfer display for local-mode file",
" transfer. The choices are:",
" ",
" BRIEF A line per file, showing size, mode, status, and throughput.",
" SERIAL One dot is printed for every K bytes transferred.",
" CRT Numbers are continuously updated on a single screen line.",
" This format can be used on any video display terminal.",
#ifdef CK_CURSES
" FULLSCREEN A fully formatted 24x80 screen showing lots of information.",
" This requires a terminal or terminal emulator.",
#endif /* CK_CURSES */
" NONE No file transfer display at all.",
" ",
"SET FILE DOWNLOAD-DIRECTORY [ <directory-name> ]",
" The directory into which all received files should be placed. By default,",
" received files go into your current directory.",
" ",
#endif /* NOXFER */
#ifdef CK_CTRLZ
"SET FILE EOF { CTRL-Z, LENGTH }",
" End-Of-File detection method, normally LENGTH. Applies only to text-mode",
" transfers. When set to CTRL-Z, this makes the file sender treat the first",
" Ctrl-Z in the input file as the end of file (EOF), and it makes the file",
" receiver tack a Ctrl-Z onto the end of the output file if it does not",
" already end with Ctrl-Z.",
" ",
#endif /* CK_CTRLZ */
"SET FILE END-OF-LINE { CR, CRLF, LF }",
" Use this command to specify nonstandard line terminators for text files.",
" ",
#ifndef NOXFER
"SET FILE INCOMPLETE { AUTO, KEEP, DISCARD }",
" What to do with an incompletely received file: KEEP (default), or DISCARD.",
" AUTO (the default) means DISCARD if transfer is in text mode, KEEP if it",
" is in binary mode.",
" ",
#ifdef VMS
"SET FILE LABEL { ACL, BACKUP-DATE, NAME, OWNER, PATH } { ON, OFF }",
" Tells which items to include (ON) or exclude (OFF) in labeled file",
" transfers",
" ",
#else
#ifdef OS2
"SET FILE LABEL { ARCHIVE, READ-ONLY, HIDDEN, SYSTEM, EXTENDED } { ON, OFF }",
" Tells which items to include (ON) or exclude (OFF) in labeled file",
" transfers.",
" ",
#endif /* OS2 */
#endif /* VMS */
"SET FILE NAMES { CONVERTED, LITERAL }",
" File names are normally CONVERTED to "common form" during transmission",
" (e.g. lowercase to uppercase, extra periods changed to underscore, etc).",
" LITERAL means use filenames literally (useful between like systems). Also",
" see SET SEND PATHNAMES and SET RECEIVE PATHNAMES.",
" ",
#ifdef UNIX
"SET FILE OUTPUT { { BUFFERED, UNBUFFERED } [ size ], BLOCKING, NONBLOCKING }",
" Lets you control the disk output buffer for incoming files. Buffered",
" blocking writes are normal. Nonblocking writes might be faster on some",
" systems but might also be risky, depending on the underlying file service.",
" Unbuffered writes might be useful in critical applications to ensure that",
" cached disk writes are not lost in a crash, but will probably also be",
" slower. The optional size parameter after BUFFERED or UNBUFFERED lets you",
" change the disk output buffer size; this might make a difference in",
" performance.",
" ",
#endif /* UNIX */
#ifdef VMS
"SET FILE RECORD-LENGTH number",
" Sets the record length for received files of type BINARY. Use this to",
" receive VMS BACKUP savesets or other fixed-format files that do not use",
" the default record length of 512.",
" ",
#endif /* VMS */
#ifdef UNICODE
"SET FILE UCS BOM { ON, OFF }",
" Whether to write a Byte Order Mark when creating a UCS-2 file.",
" ",
"SET FILE UCS BYTE-ORDER { BIG-ENDIAN, LITTLE-ENDIAN }",
" Byte order to use when creating UCS-2 files, and to use when reading UCS-2",
" files that do not start with a Byte Order Mark.",
" ",
#endif /* UNICODE */
"SET FILE WARNING { ON, OFF }",
" SET FILE WARNING is superseded by the newer command, SET FILE",
" COLLISION. SET FILE WARNING ON is equivalent to SET FILE COLLISION RENAME",
" and SET FILE WARNING OFF is equivalent to SET FILE COLLISION OVERWRITE.",
#endif /* NOXFER */
"" };
static char *hmxyhsh[] = {
"Syntax: SET HANDSHAKE { NONE, XON, LF, BELL, ESC, CODE number }",
" Character to use for half duplex line turnaround handshake during file",
" transfer. C-Kermit waits for this character from the other computer",
" before sending its next packet. Default is NONE; you can give one of the",
" other names like BELL or ESC, or use SET HANDSHAKE CODE to specify the",
" numeric code value of the handshake character. Type SET HANDSH ? for a",
" complete list of possibilities.",
"" };
#ifndef NOSERVER
static char *hsetsrv[] = {
"SET SERVER CD-MESSAGE {ON,OFF}",
" Tells whether the server, after successfully executing a REMOTE CD",
" command, should send the contents of the new directory's READ.ME",