
PKGNAME:	ksm-lib-sh-inka
VERSION:	0.2.0.1


INHALT

1.	Das Paket
1.1.	Kurzbeschreibung
1.2.	Die Dateien
1.3.	Lizenz

2.	Umgang mit dem Paket
2.1.	Voraussetzungen
2.2.	Installation/Deinstallation
2.3.	Konfiguration
2.4.	Betrieb

------------------------------------------------------------------------------

1.	Das Paket

1.1.	Kurzbeschreibung

Das Paket ksm-lib-sh-inka (vormals: Lib-SH in der Version 0.2.0 von Juergen
Kaesmann) stellt die Funktionsbibliotheken lib-ksm-func-std.sh und
lib-ksm-func-ip.sh zur Verfuegung. In diesen Bibliotheken sind Funktionen
implementiert, welche haeufig vorkommende Aufgaben erledigen.


1.2.	Die Dateien

GPL-2.0.txt		Die Gnu General Public License 2.0
LGPL-2.1.txt		Die Gnu Lesser General Public License 2.1
README			Diese Datei
install.sh		(De)Installationsprogramm
pkg.inf			Paketinformationen
lib-ksm-func-ip.sh	Funktionsbibliothek fuer IP-bezogene Funktionen
lib-ksm-func-std.sh	Funktionsbibliothek fuer Standard-Funktionen


1.3.	Lizenz

Diese Software wird unter der Gnu General Public License 2.0 bzw.
unter der Gnu Lesser General Public License 2.1 vertrieben.
Welche Lizenz fuer ein Produkt jeweils zutrifft ist aus einem Vermerk im
Header des Sourcecodes des jeweiligen Programms ersichtlich.

------------------------------------------------------------------------------

2.	Umgang mit dem Paket

2.1.	Voraussetzungen

Die Shell (Bash).

Dann sind noch folgende Programme/Pakete erforderlich: 
chown, chmod, cp, ln, mkdir, mv, rm, util-linux
Diese sind bei einer Linux-Standardinstallation i.d.R. bereits installiert.

Zusaetzlich wird das Paket inka-basis ab Version 1.3.6 benoetigt.
Es ist auf folgendem Server herunterladbar:
http://www.ingokaesmann.de/download/linux

2.2.	Installation/Deinstallation

Zuerst muessen die in der Voraussetzung genannten Pakete/Programme installiert
und (das Paket inka-basis) konfiguriert werden.
Dann mit inka-pkgmanager dieses Paket installieren.
Eine Deinstallation erfolgt ebenfalls mit inka-pkgmanager.

Achtung - wenn aeltere Pakete eine alte Bibliotheks-Version von ksm-lib-sh-inka
benoetigen, empfiehlt es sich nicht, die dazu passende Version komplett zu
deinstallieren.
Stattdessen sollte die neue Version einfach installiert werden.
Vorhandene Links auf die Libraries werden automatisch umgesetzt auf die neue 
Version. Benoetigt aeltere Software noch die alten Libraries, dann koennen 
diese in den aufrufenden Scripten direkt mit Angabe der Version eingetragen 
werden.

Beispiel:
Version 0.0.0 wird durch Version 0.0.1 ersetzt.
Das Script 'doit.sh' benoetigt aber noch die alte Version 0.0.0
Es kann nun im Script 'doit.sh' die Zeile mit dem Aufruf der Library
. $LLIBDIR/lib-ksm-func-std.sh

wie folgt abgeaendert werden:
. $LLIBDIR/lib-ksm-func-std.sh-0.0.0

Wenn sichergestellt ist, dass die aelteren Libraries nicht benoetigt werden, 
dann koennen diese natuerlich entfernt werden (ACHTUNG - die Versions-Nr. 
angeben).

Beispiele:
rm /usr/local/lib/sh/lib-ksm-func-ip.sh-0.0.0
rm /usr/local/lib/sh/lib-ksm-func-std.sh-0.0.0


2.3.	Konfiguration

Es gibt nichts zu konfigurieren.

2.4.	Betrieb

Nach der Installation koennen die Bibliotheken durch einen Aufruf (sogenanntes
sourcen) in ein Script eingebunden werden. Damit stehen die Funktionen der 
Bibliothek dem Script zur Verfuegung. Die func-ip.sh benoetigt zur 
Ausfuehrung die func-std.sh, d.h. diese muss im aufrufenden Script ebenfalls 
aktiviert werden.

------------------------------------------------------------------------------

Viel Spass :-)

Juergen Kaesmann
eMail: juergen@kaesmann.us
HTTP : http://www.kaesmann.us
FTP  : ftp://ftp.kaesmann.us

Modifiziert von Ingo Kaesmann.
HTTP: http://www.ingokaesmann.de/

Berlin, den 04.09.2013
