ftp.nice.ch/pub/next/unix/database/sybtool.1.3.README

This is the README for sybtool.1.3.s.tar.gz [Download] [Browse] [Up]

 WHAT IS THIS?
 ============= 

This  is SYBTOOL   v1.3  -  a better  (I    hope) choice   for  SYBASE
administrators and developers than "isql".

 AUTHOR
 ======

 Ivan Kiselev
 ivank@crt.com or ivank@mcs.com
 441 Elm St.
 Deerfield, IL 60015

 FEATURES
 ========

Basically, it provides   interactive access to  Sybase   SQL server. It
allows command-line editing (a  la Korn-shell) with Emacs  key binding
and it saves (and, of course, restores) editing history.


 REQUIREMENTS
 ============

This software  should compile on  most Unix platforms  with  a C++ v.3
compiler with little or no  difficulty.  You  will  need to tweak  the
Makefiles in order to make them work for your C++ compiler.

Of course, you should   have Sybase. I tried  it  with v.10 and  v.4.x
should be fine too (I did not use anything specific to v.10).


 CONTENTS
 ========

LineEdit/	Command-line editing package by 
		Chris Thewalt (thewalt@ce.berkeley.edu) 

cmdline-1.04/	C++ library for parsing command arguments and assigning
		the corresponding values to program variables by Brad
		Appleton (brad@ssd.csd.harris.com)

Makefile	Main make-file
Stack.H		Stack template
String.H	My scaled-down version of yet another String class
debug.H		A macro for debuging
makefile.hp	HP-UX settings for main make-file
makefile.next	NeXTSTEP settings for main make-file
sybtool.C	Main program
sybtool.1	Man page


 BUILDING, PORTING AND INSTALLATION
 ==================================

You should change the variable PLATFORM in the Makefile for a specific
platform you are  building for.  All  platform-dependent stuff is   in
makefile.$(PLATFORM), so you should get it right either.

If you wish to have more lines in you command line history, you should
redefine variable $(HIST_SIZE) which is set to 100 by default.

You may need to tweak  the makefiles a bit  in order to get everything
build properly.  Please, see README files in LineEdit and cmdline-1.04
directories  for  specific  instructions  regarding  these  respective
packages.

I was  able to build  everithyng for HP-UX and  NeXT without any major
difficulties.

There is no "install" target  in the makefile  - just copy  executable
file "sybtool" to whatever place you decide it should live in.

 RUNNING
 =======

I  believe  that    diagnostic   for   command-line   parameters    is
self-explanatory, but man-page is available anyway.

You also can use SYBTOOL in a batch mode like this:

$cat my_big_sql_file.sql | sybtool -U user -P passw -S server

 BUGS
 ====

Please   send all  bug  reports   to   Ivan Kiselev  ivank@crt.com  or
ivank@mcs.com .  Don't forget to  mention which version of SYBTOOL you
have and which operating system and C++ compiler you are using.


 ACKNOWLEDGMENTS
 ================

I'd like to  thank  Chris Thewalt (thewalt@ce.berkeley.edu)  and  Brad
Appleton    (brad@ssd.csd.harris.com)   for  their extreamly   useful
packages I enjoyed using.

Without Jerlene Cannon the man-page whould never be readable.



 COPYRIGHT TRANSLATED INTO READABLE ENGLISH
 ==========================================

The copyright note at next section means that  you can do whatever you
want with  the  package, but if you  are  using it  to  make a profit,
please, share it (profit) with me.

Here is the procedure for sharing a profit: send me a signed licensing
agreement with the  check for a reasonable amount.  If I like  both of
them,  I'll cash the check,  sign  the licensing  agreement, send
agreement back to you, and we are all set.

 COPYRIGHT
 =========

Copyright (C) 1994, Ivan Kiselev

Everything    not    already copyrighted   by      Brad Appleton  (see
./cmdline-1.04/README) or Chris  Thewalt (see ./LineEdit/getline.c) is
copyrighted by Ivan Kiselev.

SYBTOOL software,   both  binary and source   (hereafter, Software) is
copyrighted by Ivan Kiselev, and ownership remains with Ivan Kiselev.

Ivan  Kiselev grants you  (hereafter, Licensee)  a  license to use the
Software for academic,  research and internal business  purposes only,
without a fee.  Licensee may distribute the binary and source code (if
released) to third parties provided that the copyright notice and this
statement appears on all copies and that no  charge is associated with
such copies.

Licensee may make derivative works.   However, if Licensee distributes
any  derivative  work  based on  or  derived  from the  Software, then
Licensee will (1) notify Ivan   Kiselev regarding its distribution  of
the derivative work, and (2) clearly notify users that such derivative
work is a modified version and not the original SYBTOOL distributed by
Ivan Kiselev.

Any Licensee  wishing to make  commercial use  of the Software  should
contact  Ivan Kiselev  to negotiate  an  appropriate license for  such
commercial  use.  Commercial  use includes  (1) integration  of all or
part of the  source code into a product  for sale or  license by or on
behalf of Licensee to third parties, or (2) distribution of the binary
code or source   code  to third parties   that  need it   to utilize a
commercial product sold or licensed by or on behalf of Licensee.

IVAN KISELEV MAKES NO REPRESENTATIONS   ABOUT THE SUITABILITY OF  THIS
SOFTWARE FOR ANY  PURPOSE.  IT IS PROVIDED  "AS IS" WITHOUT EXPRESS OR
IMPLIED WARRANTY.  IVAN KISELEV  SHALL NOT BE  LIABLE FOR  ANY DAMAGES
SUFFERED BY THE USERS OF THIS SOFTWARE.

By  using or  copying this Software,  Licensee agrees  to abide by the
copyright law and all other applicable laws of the U.S. including, but
not  limited to, export  control laws, and  the terms of this license.
Ivan     Kiselev shall  have   the  right   to terminate  this license
immediately   by   written notice   upon   Licensee's  breach  of,  or
non-compliance with, any of its  terms.  Licensee may be held  legally
responsible    for  any  copyright   infringement  that is   caused or
encouraged    by Licensee's failure   to abide  by  the  terms of this
license.

Comments and questions are welcome and can be sent to ivank@crt.com or
ivank@mcs.com

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.