home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ckv192.zip / ckermit.upd < prev    next >
Text File  |  1996-12-28  |  16KB  |  423 lines
  1. File CKERMIT.UPD, Supplement to "Using C-Kermit", Second Edition   -*- text -*-
  2.  
  3. As of C-Kermit version:  6.0.192
  4. This file last updated:  6 Dec 1996
  5.  
  6. Authors: Frank da Cruz and Christine M. Gianone
  7. Address: The Kermit Project
  8.          Watson Laboratory
  9.          Columbia University
  10.          612 West 115th Street, New York NY 10025-7799, USA.
  11. Fax:     +1 (212) 662-6442  -- or --  +1 (212) 663-8202
  12. E-Mail:  kermit@columbia.edu
  13. Web:     http://www.columbia.edu/kermit/
  14.  
  15.   Copyright (C) 1992, 1996, Trustees of Columbia University in the City of
  16.   New York.  All rights reserved.
  17.  
  18. ------------------------------
  19. WHAT IS IN THIS FILE
  20.  
  21. This file lists changes made to C-Kermit since the second edition of the book
  22. "Using C-Kermit" was published in November 1996.  Use this file as a
  23. supplement to the second edition of "Using C-Kermit".  If the "most recent
  24. update" shown above is long ago, contact Columbia University to see if there
  25. is a newer release.
  26.  
  27. For further information, also see the CKERMIT.BWR ("C-Kermit beware") file for
  28. hints, tips, tricks, restrictions, frequently asked questions, etc, plus the
  29. system-specific "beware file", e.g. CKUKER.BWR for UNIX, CKVKER.BWR for VMS,
  30. etc, and also any system-specific update files such as CKERMIT.INF for OS/2,
  31. or BUGS.DOC and UPDATES.DOC for Windows 95 and NT.
  32.  
  33. ------------------------------
  34. NOTE TO KERMIT 95 USERS
  35.  
  36. This file concentrates on the aspects of C-Kermit that are common to all
  37. versions: UNIX, VMS, OS/2, etc.  Please refer to your Kermit 95 documentation:
  38. the "Kermit 95" booklet, the UPDATES.DOC and BUGS.DOC files, and to all the
  39. other files in the Kermit 95 DOCS directory for information that is specific
  40. to Kermit 95.  Also, please note that "Using C-Kermit" predates Kermit 95
  41. altogether, and so please pardon the fact that it does not mention Windows 95
  42. or NT; it is still the definitive reference for the C-Kermit command and
  43. script programming language.
  44.  
  45. -----------------------------------------
  46. A WORD ABOUT VERSIONS AND VERSION NUMBERS
  47.  
  48. "C-Kermit" refers to all the many programs that are compiled in whole or in
  49. part from common C-language source code, comprising:
  50.  
  51.  . A Kermit file transfer protocol module
  52.  . A command parser and script execution module
  53.  . A modem-dialing module
  54.  . A network support module
  55.  . A character-set translation module.
  56.  
  57. and several others.  These "system-independent" modules are combined with
  58. system-dependent modules for each platform to provide the required
  59. input/output functions, and also in some cases overlaid with an alternative
  60. user interface, such as Macintosh Kermit's point-and-click interface, and in
  61. some cases also a terminal emulator, as Kermit 95.
  62.  
  63. The C-Kermit version number started as 1.0, ... 3.0, 4.0, 4.1 and then
  64. (because of confusion at the time with Berkeley UNIX 4.2), 4B, 4C, and so on,
  65. with the specific edit number in parentheses, for example 4E(072) or 5A(188).
  66. This scheme was used through 5A(191), but now we have gone back to the
  67. traditional numbering scheme with decimal points:  major.minor.edit; for
  68. example 6.0.192.
  69.  
  70. Meanwhile, C-Kermit versions for some platforms might go through several
  71. releases while C-Kermit itself remains the same.  These versions have their
  72. own platform-specific version numbers, such as Kermit 95 1.1.1, 1.1.2, and
  73. so on.
  74.  
  75. ------------------------------
  76. CONTENTS
  77.  
  78.  I.  C-KERMIT DOCUMENTATION: Information about the C-Kermit manual.
  79.  
  80.  II. NEW FEATURES: Documentation for features added since 6.0.192 --
  81.  
  82.      (1) PROGRAM MANAGEMENT AND COMMANDS
  83.          1.1. Command Continuation
  84.      (2) MAKING AND USING CONNECTIONS
  85.      2.1. Modems
  86.      2.2. TELNET and RLOGIN
  87.      2.3. The EIGHTBIT command
  88.      2.4. The Services Directory
  89.      (3) TERMINAL CONNECTION
  90.      (4) FILE TRANSFER AND MANAGEMENT
  91.      (5) NEW CLIENT/SERVER FEATURES
  92.      (6) INTERNATIONAL CHARACTER SETS
  93.          6.1. The HP-Roman8 Character Set
  94.      (7) SCRIPT PROGRAMMING
  95.          7.1. INPUT Command Details
  96.      (8) USING OTHER FILE TRANSFER PROTOCOLS
  97.      (9) NEW COMMAND-LINE OPTIONS
  98.  
  99. III. APPENDICES  
  100.  
  101. IV. ERRATA & CORRIGENDA: Corrections to "Using C-Kermit"
  102.  
  103. ------------------------------
  104. I. C-KERMIT DOCUMENTATION
  105.  
  106. The user manual for C-Kermit is:
  107.  
  108.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Second Edition,
  109.   Digital Press /  Butterworth-Heinemann, Woburn, MA, 1997, 622 pages,
  110.   ISBN 1-55558-164-1.
  111.  
  112.   US single-copy price: $39.95; quantity discounts available.  Available in
  113.   computer bookstores or directly from Columbia University:
  114.  
  115.     The Kermit Project
  116.     Columbia University
  117.     612 West 115th Street
  118.     New York NY  10025-7799
  119.     USA
  120.     Telephone: +1 (212) 854-3703
  121.     Fax:       +1 (212) 663-8202
  122.  
  123.   Domestic and overseas orders accepted.  Price: US $39.95 (US, Canada, and
  124.   Mexico), $50 elsewhere.  Orders may be paid by MasterCard or Visa, or
  125.   prepaid by check in US dollars.  Add $35 bank fee for checks not drawn on
  126.   a US bank.  Price includes shipping.  Do not include sales tax.
  127.   Inquire about quantity discounts.
  128.  
  129.   You can also order by phone from the publisher, Digital Press /
  130.   Butterworth-Heinemann, with MasterCard, Visa, or American Express:
  131.  
  132.     +1 800 366-2665   (Woburn, Massachusetts office for USA & Canada)
  133.     +44 1865 314627   (Oxford, England distribution centre for UK & Europe)
  134.     +61 03 9245 7111  (Melbourne, Vic, office for Australia & NZ)
  135.     +65 356-1968      (Singapore office for Asia) 
  136.     +27 (31) 2683111  (Durban office for South Africa)
  137.  
  138.   A German-language edition of the First Edition is also available:
  139.  
  140.     Frank da Cruz and Christine M. Gianone, "C-Kermit - Einfuehrung und
  141.     Referenz", Verlag Heinz Heise, Hannover, Germany (1994).
  142.     ISBN 3-88229-023-4.  Deutsch von Gisbert W. Selke.  Price: DM 88,00.  
  143.     Verlag Heinz Heise GmbH & Co. KG, Helstorfer Strasse 7, D-30625 Hannover.
  144.     Tel. +49 (05 11) 53 52-0, Fax. +49 (05 11) 53 52-1 29.
  145.  
  146. The Kermit file transfer protocol is specified in:
  147.  
  148.   Frank da Cruz, "Kermit, A File Transfer Protocol", Digital Press,
  149.   Bedford, MA, 1987, 379 pages, ISBN 0-932376-88-6.
  150.   US single-copy price: $32.95.  Availability as above.
  151.  
  152. Kermit for Windows 95 is documented in:
  153.  
  154.   Christine M. Gianone and Frank da Cruz, "Kermit 95",
  155.   Manning Publications, Greenwich CT (1996), 88 pages, ISBN 1-884777-14-7.
  156.   US single-copy price: $14.95.  Included in Kermit 95 shrink wrapped
  157.   package and available separately from Columbia University or direct
  158.   from the publisher:
  159.  
  160.     Manning Publications Co.
  161.     3 Lewis Street
  162.     Greenwich CT  06830
  163.     USA
  164.     Fax:   +1 (203) 661 9018
  165.     Email: 73150.1431@compuserve.com
  166.  
  167. News and articles about Kermit software and protocol are published
  168. periodically in the journal, Kermit News.  Subscriptions are free; contact
  169. Columbia University at the address above.
  170.  
  171. Online news about Kermit is published in the comp.protocols.kermit.announce
  172. and comp.protocols.kermit.misc newsgroups.
  173.  
  174. ------------------------------
  175. II. NEW FEATURES
  176.  
  177. Support for the Bell Labs Plan 9 operating system was added to version
  178. 6.0.192 too late to be mentioned in the book (although it does appear on
  179. the cover).
  180.  
  181. Specific items below are grouped together by major topic, roughly
  182. corresponding to the chapters of "Using C-Kermit".
  183.  
  184. (1) PROGRAM MANAGEMENT AND COMMANDS
  185.  
  186. 1.1. Command Continuation
  187.  
  188. Comments that start with ";" or "#" can no longer be continued.  In:
  189.  
  190.   ; this is a comment -
  191.   echo blah
  192.  
  193. the ECHO command will execute, rather than being taken as a continuation of
  194. the preceding comment line.  However, the text of the COMMENT command can
  195. still be continued onto subsequent lines:
  196.  
  197.   comment this is a comment -
  198.   echo blah
  199.  
  200. As of version 6.0.192, backslash is no longer a valid continuation character.
  201. Only hyphen should be used for command continuation.  This is to make it
  202. possible to issue commands like "cd a:\" on DOS-like systems.
  203.  
  204. (2) MAKING AND USING CONNECTIONS
  205.  
  206. 2.1. Modems
  207.  
  208. Cardinal modem type added, for Cardinal V.34 MVP288X series.
  209.  
  210. 2.2. TELNET and RLOGIN
  211.  
  212. SET TELNET BUG BINARY-ME-MEANS-U-TOO { ON, OFF } was added to edit 192
  213. after the book was printed.  Also SET TELNET BUG BINARY-U-MEANS-ME-TOO.
  214. The default for both is OFF.  ON should be used when communicating with a
  215. Telnet partner (client or server) that mistakenly believes that telling
  216. C-Kermit to enter Telnet binary mode also means that it, too, is in binary
  217. mode, contrary to the Telnet specification, which says that binary mode must
  218. be negotiated in each direction separately.
  219.  
  220. The RLOGIN section on page 123 does not make it clear that you can use the
  221. SET TELNET TERMINAL-TYPE command to govern the terminal type that is reported
  222. by C-Kermit to the RLOGIN server.
  223.  
  224. Note that the SET TCP commands described on pages 122-123 might be absent;
  225. some platforms that support TCP/IP do not support these particular controls.
  226.  
  227. 2.3. The EIGHTBIT command
  228.  
  229. EIGHTBIT is simply a shorthand for: SET PARITY NONE, SET TERMINAL BYTESIZE 8,
  230. SET COMMAND BYTESIZE 8; that is, a way to set up an 8-bit clean connection
  231. in a single command.
  232.  
  233. 2.4. The Services Directory
  234.  
  235. Chapter 7 of "Using C-Kermit" does not mention the ULOGIN macro, which is
  236. used by our sample services directory, CKERMIT.KND.  Unlike UNIXLOGIN,
  237. VMSLOGIN, etc, this one is for use with systems that require a user ID but
  238. no password.  Therefore it doesn't prompt for a password or wait for a
  239. password prompt from the remote service.
  240.  
  241. (3) TERMINAL CONNECTION
  242.  
  243. (4) FILE TRANSFER
  244.  
  245. (5) NEW CLIENT/SERVER FEATURES
  246.  
  247. (6) INTERNATIONAL CHARACTER SETS
  248.  
  249. 6.1. The HP-Roman8 Character Set
  250.  
  251. The HP-Roman8 character set was omitted from Table VII-4:
  252.  
  253. Hewlett Packard Roman8 Character Set
  254. dec col/row oct hex  description
  255. 160  10/00  240  A0  (Undefined)
  256. 161  10/01  241  A1  A grave
  257. 162  10/02  242  A2  A circumflex
  258. 163  10/03  243  A3  E grave
  259. 164  10/04  244  A4  E circumflex
  260. 165  10/05  245  A5  E diaeresis
  261. 166  10/06  246  A6  I circumflex
  262. 167  10/07  247  A7  I diaeresis
  263. 168  10/08  250  A8  Acute accent
  264. 169  10/09  251  A9  Grave accent
  265. 170  10/10  252  AA  Circumflex accent
  266. 171  10/11  253  AB  Diaeresis
  267. 172  10/12  254  AC  Tilde accent
  268. 173  10/13  255  AD  U grave
  269. 174  10/14  256  AE  U circumflex
  270. 175  10/15  257  AF  Lira symbol
  271. 176  11/00  260  B0  Top bar (macron)
  272. 177  11/01  261  B1  Y acute
  273. 178  11/02  262  B2  y acute
  274. 179  11/03  263  B3  Degree Sign
  275. 180  11/04  264  B4  C cedilla
  276. 181  11/05  265  B5  c cedilla
  277. 182  11/06  266  B6  N tilde
  278. 183  11/07  267  B7  n tilde
  279. 184  11/08  270  B8  Inverted exclamation mark
  280. 185  11/09  271  B9  Inverted question mark
  281. 186  11/10  272  BA  Currency symbol
  282. 187  11/11  273  BB  Pound sterling symbol
  283. 188  11/12  274  BC  Yen symbol
  284. 189  11/13  275  BD  Paragraph
  285. 190  11/14  276  BE  Florin (Guilder) symbol
  286. 191  11/15  277  BF  Cent symbol
  287. 192  12/00  300  C0  a circumflex
  288. 193  12/01  301  C1  e circumflex
  289. 194  12/02  302  C2  o circumflex
  290. 195  12/03  303  C3  u circumflex
  291. 196  12/04  304  C4  a acute
  292. 197  12/05  305  C5  e acute
  293. 198  12/06  306  C6  o acute
  294. 199  12/07  307  C7  u acute
  295. 200  12/08  310  C8  a grave
  296. 201  12/09  311  C9  e grave
  297. 202  12/10  312  CA  o grave
  298. 203  12/11  313  CB  u grave
  299. 204  12/12  314  CC  a diaeresis
  300. 205  12/13  315  CD  e diaeresis
  301. 206  12/14  316  CE  o diaeresis
  302. 207  12/15  317  CF  u diaeresis
  303. 208  13/00  320  D0  A ring
  304. 209  13/01  321  D1  i circumflex
  305. 210  13/02  322  D2  O with stroke
  306. 211  13/03  323  D3  AE digraph
  307. 212  13/04  324  D4  a ring
  308. 213  13/05  325  D5  i acute
  309. 214  13/06  326  D6  o with stroke
  310. 215  13/07  327  D7  ae digraph
  311. 216  13/08  330  D8  A diaeresis
  312. 217  13/09  331  D9  i grave
  313. 218  13/10  332  DA  O diaeresis
  314. 219  13/11  333  DB  U diaeresis
  315. 220  13/12  334  DC  E acute
  316. 221  13/13  335  DD  i diaeresis
  317. 222  13/14  336  DE  German sharp s
  318. 223  13/15  337  DF  O circumflex
  319. 224  14/00  340  E0  A acute
  320. 225  14/01  341  E1  A tilde
  321. 226  14/02  342  E2  a tilde
  322. 227  14/03  343  E3  Icelandic Eth
  323. 228  14/04  344  E4  Icelandic eth
  324. 229  14/05  345  E5  I acute
  325. 230  14/06  346  E6  I grave
  326. 231  14/07  347  E7  O acute
  327. 232  14/08  350  E8  O grave
  328. 233  14/09  351  E9  O tilde
  329. 234  14/10  352  EA  o tilde
  330. 235  14/11  353  EB  S caron
  331. 236  14/12  354  EC  s caron
  332. 237  14/13  355  ED  U acute
  333. 238  14/14  356  EE  Y diaeresis
  334. 239  14/15  357  EF  y diaeresis
  335. 240  15/00  360  F0  Icelandic Thorn
  336. 241  15/01  361  F1  Icelandic thorn
  337. 242  15/02  362  F2  Middle dot
  338. 243  15/03  363  F3  Greek mu
  339. 244  15/04  364  F4  Pilcrow sign
  340. 245  15/05  365  F5  Fraction 3/4
  341. 246  15/06  366  F6  Long dash, horizontal bar
  342. 247  15/07  367  F7  Fraction 1/4
  343. 248  15/08  370  F8  Fraction 1/2
  344. 249  15/09  371  F9  Feminine ordinal
  345. 250  15/10  372  FA  Masculine ordinal
  346. 251  15/11  373  FB  Left guillemot
  347. 252  15/12  374  FC  Solid box
  348. 253  15/13  375  FD  Right guillemot
  349. 254  15/14  376  FE  Plus or minus sign
  350. 255  15/15  377  FF  (Undefined)
  351.  
  352. (7) SCRIPT PROGRAMMING
  353.  
  354. 7.1. INPUT Command Details
  355.  
  356. The description of the INPUT command on page 422 fails to mention the
  357. following two points about the timeout:
  358.  
  359.  1. "INPUT -1 text" (or "INPUT \%x text", where \%x is any variable whose 
  360.     value is -1 or less) means "wait forever".
  361.  
  362.  2. "INPUT 0 text" means don't wait at all -- fail immediately if the text 
  363.     is not already waiting to be read.
  364.  
  365. The same points apply to MINPUT.
  366.  
  367. (8) USING OTHER FILE TRANSFER PROTOCOLS
  368.  
  369. (9) NEW COMMAND-LINE OPTIONS
  370.  
  371. III. APPENDICES
  372.  
  373. Figure II-5 on page 494.  The pin assignments of the Mini Din-8 connector
  374. are not described anywhere.  As noted in the text, these tend to vary from
  375. vendor to vendor.  One common arrangement is:
  376.  
  377.   1. HSKout (Handshake out -- definition depends on software)
  378.   2. HSKin  (Handshake in or external clock)
  379.   3. TxD-
  380.   4. Not used
  381.   5. RxD-
  382.   6. TxD+
  383.   7. Not used
  384.   8. RxD+
  385.  
  386. Note the "balanced pairs" for Receive Data (RxD) and Transmit Data (TxD), and
  387. the utter lack of modem signals.  These connectors follow the RS-423 standard,
  388. rather than RS-232.  In some arrangements, Pin 1 is used for DTR and Pin 2 for
  389. CD; in others Pin 1 is RTS and Pin 2 is CTS.
  390.  
  391. IV. ERRATA & CORRIGENDA
  392.  
  393. The following errors in "Using C-Kermit", Second Edition, first printing,
  394. have been noted:
  395.  
  396. First, some missing acknowledgements: JE Jones of Microware for help with
  397. OS-9, Nigel Roles for his help with Plan 9, Lucas Hart for help with VMS and
  398. Digital UNIX, Igor Kovalenko for his help with QNX.
  399.  
  400. PAGE    REMARKS
  401. COVER   "COS" is a misprint.  There is no COS.  Pretend it says "SCO" or "VOS".
  402. 123     Third paragraph from bottom: "..otherwise if a your local username.."
  403.         should be "..otherwise your local username..".
  404. 298     Table 16-2, Portuguese entry.  Column 4/00 should show section sign,
  405.         not acute accent.
  406. 453     "the the" (last paragraph) should be "the".
  407. 454     EOT (last paragraph) is End of Transmission, not End of Text.
  408. 457     "macro for and" (last paragraph) should be "macro and".
  409. 560-563 HP-Roman8 missing from Table VII-4.  It is listed in section II(6).
  410. 565     "d stroke" in Table VII-5 has the wrong appearance; the stem should
  411.         be upright.  The letter shown in the table is actually a lowercase
  412.         Icelandic eth, which has a curved stem.
  413. 601-604 BeBox, BeOS, Plan 9, and probably others not listed in trademarks.
  414. 604     The words "SCRIBE TEXT FORMATTER" appear at the end of the last
  415.         sentence of the first parapgraph of the Colophon.  They should have
  416.         been in the Index.
  417.  
  418. Please send reports of other errors to the authors, as well as suggestions for
  419. improvements, additional index entries, and any other comments.
  420.  
  421. ------------------------------
  422. END OF CKERMIT.UPD
  423.