How to Contribute a C-Kermit Binary

[ Unix ] [ VMS ] [ Other ]


Unix

  1. Check the binaries table to make sure the binary you are about to make is not already there, or is not at the current C-Kermit release level (i.e. 8.0.206).

  2. Make a fresh directory and 'cd' to it. Example:

      $ mkdir kermit
      $ cd kermit
    

  3. Download the appropriate source code archive. Click on the download link or do it by hand the old-fashioned way. Example:

      $ ftp kermit.columbia.edu
      User: anonymous
      Password: olga@xyzcorp.com
      ftp> cd kermit/archives
      ftp> binary
      ftp> get cku206.tar.gz
      ftp> bye
      $
    

    Alternatively, if you have a fairly recent Kermit client (C-Kermit 7.0 or later, or K95 1.1.20), you can download the archive with Kermit itself, from the Kermit Project's Internet Kermit Service:

      $ kermit
      C-Kermit> iksd /user:anonymous kermit.columbia.edu
      Enter e-mail address as Password: olga@xyzcorp.com
      (/) IKSD> send kermit/archives/cku206.tar.gz
      (/) IKSD> exit
      C-Kermit> exit
      $
    

  4. If you downloaded a compressed tar file, uncompress it. Examples:

      $ gunzip cku206.tar.gz
      $ uncompress cku206.tar.Z
    

  5. If you downloaded a tar archive, "un-tar" it. Example:

      $ tar xvf cku206.tar
    

    If you downloaded a Zip archive, unzip it. Example:

      $ unzip -a cku206.zip
    

  6. Now you can delete the tar archive (or zip archive) if you wish:

      $ rm cku206.tar                 (or rm cku206.zip)
    

  7. Read the comments at the top of the makefile to find out which target is appropriate for your computer and operating system, and then give the appropriate "make" command. Examples:

      $ make linux                    (Linux, almost any version)
      $ make freebsd44                (FreeBSD 4.4)
      $ make solaris8                 (Solaris 8 with cc)
      $ make solaris8g                (Solaris 8 with gcc)
      $ make irix62                   (IRIX 6.2)
    

  8. Rename (or copy, or link) the resulting "wermit" binary to match the naming conventions in the C-Kermit binaries table. In most cases, this would be:

      cku206.makefiletarget-architecture-osversion
    

    Examples:

      cku206.linux-alpha-db2.2        (Debian Linux 2.2 on the Alpha)
      cku206.linux-i386-db2.2         (Debian Linux 2.2 on a PC)
      cku206.solaris25-i386-2.5.1     (Solaris 2.5.1 on a PC)
      cku206.solaris25-sparc-2.5.1    (Solaris 2.5.1 on a Sun)
      cku206.solaris25g-sparc-2.5.1   (Ditto but built with gcc)
    

    For some platforms, additional information must be included in the name. For Silicon Graphics IRIX, for example, we need the Instruction Set Architecture (MIPS level) and the Application Binary Interface:

      cku206.linux-alpha-db2.2
      cku206.linux-i386-db2.2
      cku206.solaris25-i386-2.5.1
      cku206.solaris25-sparc-2.5.1
    

      cku206.irix53-mips2-o32-5.3
      cku206.irix65-mips3-n32-6.5.14m
    

  9. If you want to make another binary, use the "clean" target to remove the object files:
      $ make clean
    

    and then go back to step 7.

  10. Upload the binary (or binaries) you have built to ftp://kermit.columbia.edu/kermit/incoming/. You can use FTP or Kermit. Example:

      $ cp wermit cku206.irix62-mips3-n32.6.2
      $ ftp kermit.columbia.edu
      User: anonymous
      Password: olga@xyzcorp.com
      ftp> cd kermit/incoming
      ftp> binary
      ftp> put cku206.irix62-mips3-n32.6.2
      ftp> bye
      $
    

  11. If you compress the binary, be sure to include the appropriate compression suffix (.Z or .gz) in the filename. Example:

      $ cp wermit cku206.irix62-mips3-n32.6.2
      $ gzip cku206.irix62-mips3-n32.6.2
      $ ftp kermit.columbia.edu
      User: anonymous
      Password: olga@xyzcorp.com
      ftp> cd kermit/incoming
      ftp> binary
      ftp> put cku206.irix62-mips3-n32.6.2,gz
      ftp> bye
      $
    

  12. Send e-mail to kermit@columbia.edu and let us know that you uploaded a binary and give any relevant information: machine/OS model and particulars, any error messages or warnings, any changes you had to make to the build procedure or source code.

  13. To install the version of Kermit you have just built, read the installation instructions.

Thanks!


VMS

  1. Check the binaries table to make sure the binary you are about to make is not already there, or is not at the current C-Kermit release level (i.e. 8.0.206).

  2. Make a fresh directory and SET DEFAULT to it. Example:

      $ create/directory kermit
      $ set default [.kermit]
    

  3. Download the VMS source code Zip archive. Click on the download link or do it by hand the old-fashioned way. Example:

      $ ftp kermit.columbia.edu
      User: anonymous
      Password: olga@xyzcorp.com
      ftp> cd kermit/archives
      ftp> binary
      ftp> get ckv206.zip
      ftp> bye
      $
    

    Or use the Internet Kermit service as described above.

  4. Unpack the Zip archive. Example:

      $ unzip -a ckv206.zip
    

  5. Run the build procedure to make a "no-net" version (i.e. a version that does not have TCP/IP networking built in:

      $ @ckvker n
    

    If you have a pre-5.0 VMS release, use the "old" build procedure:

      $ @ckvold n
    

    If you experience any trouble, read the comments at the top of the build procedure.

  6. Rename the resulting WERMIT.EXE binary to match the naming conventions in the C-Kermit binaries table:

      ckv206-architecture-vmsNN-nonet.exe
    

    where architecture is "vax" or "axp" (or maybe by the time you read this, "ia64"); NN is the VMS version number, such as "72" for 7.2, and "nonet" means no networking. Examples:

      ckv206-vax-vms47-nonet.exe
      ckv206-axp-vms62-nonet.exe
    

  7. If you have a TCP/IP product installed, create a second binary with TCP/IP networking built in:

      $ @ckvker
    

    (or @ckvold for VMS 4.x or ealier).

  8. Rename the second WERMIT.EXE binary like the first one, except this time include the TCP/IP product and version:

      ckv206-architecture-vmsNN-netVV.exe
    

    where netVV is a three-letter code for the network product and its two-digit version number (with no decimal point):

      ucx  DEC TCP/IP
      tgv  TGV MultiNet
      pst  Process Software TCPware
      twg  The Wollongong Group WIN/TCP or PathWay
      cmu  Carnegie-Mellon University CMU/IP

    Examples:

      ckv206-vax-vms55-ucx20.exe
      ckv206-axp-vms62-tgv41.exe
      ckv206-axp-vms73-ucx51.exe
    

  9. If you want to make more binaries, use the build procedure's "c" option to remove the object files:
      $ @ckvker c
    

    and then go back to step 5.

  10. Upload the binary (or binaries) you have built to ftp://kermit.columbia.edu/kermit/incoming/. You can use FTP or Kermit. Example:

      $ ftp kermit.columbia.edu
      User: anonymous
      Password: olga@xyzcorp.com
      FTP> cd kermit/incoming
      FTP> binary
      FTP> mput ckv206*.exe
      FTP> bye
      $
    

  11. Send e-mail to kermit@columbia.edu and let us know that you uploaded a binary and give any relevant information: machine/OS model and particulars, any error messages or warnings, any changes you had to make to the build procedure or source code.

  12. To install the version of Kermit you have just built, read the installation instructions.

Thanks!


Other

Contact us.

[ Top ] [ C-Kermit Home ] [ Kermit Home ]


C-Kermit 8.0 / Columbia University / kermit@columbia.edu / 24 October 2002