ESTIC is an Enhanced Supervisor Tool for ISTEC Configuration.

The German manufacturer Emmerich makes Istec 1003 & 1008 TK-Anlagen.
The TK-Anlage is an ISDN PBX ( Private Branch Exchange ).

Submitted by:	Julian Stacey

10 files changed, 824 insertions, 0 deletions

diff --git a/misc/estic/Makefile b/misc/estic/Makefile
new file mode 100644
index 00000000000..fd6b8083408
--- /dev/null
+++ b/misc/estic/Makefile
@@ -0,0 +1,87 @@
+# FreeBSD ports collection makefile for:	estic
+# Version required:				1.40
+# Date created:					21 Sep 1996
+# Whom:						Julian Stacey <jhs@freebsd.org>
+#
+# $Id: Makefile,v 1.2 1996/12/28 00:19:55 asami Exp $
+#
+
+DISTNAME=		estic-1.40-sources
+PKGNAME=		estic-1.40
+CATEGORIES=		misc
+MASTER_SITES=		ftp://linux01.gwdg.de/pub/isdn/estic/  \
+			ftp://ftp.franken.de/pub/isdn4linux/estic/  \
+			http://www.fast.de/~uli/isdn/estic/
+EXTRACT_SUFX=		.zip
+
+MAINTAINER=		jhs@FreeBSD.org
+
+BUILD_DEPENDS=		unzip:${PORTSDIR}/archivers/unzip
+
+EXTRACT_CMD=		unzip
+EXTRACT_BEFORE_ARGS=#	-q
+NO_WRKSUBDIR=		yes
+
+#			maybe one of them depends on the vga font from pcemu ?
+X_OR_NOT=-x#		With X Window System,		Runs OK
+#X_OR_NOT=#		Without X Window System,	Compile fails
+AUTHOR=			"Ullrich von Bassewitz" <uz@ibb.schwaben.com>
+
+# Personal Preferences, Where to install.
+PBX_VAR=${PREFIX}/var/log/pbx
+PBX_ETC=${PREFIX}/etc/pbx
+PBX_MAN=${PREFIX}/man/man1
+PBX_BIN=${PREFIX}/bin
+PBX_DOC=${PREFIX}/share/doc/estic
+ESTIC=${WRKSRC}/estic
+MAKE_E= make X11BASE=${X11BASE} -f make/freebsd${X_OR_NOT}.mak
+
+do-configure:
+	@cd ${WRKSRC}/spunk ; ${MAKE_E} dep
+	@cd ${ESTIC} ; ${MAKE_E} dep
+
+do-build:
+	@# If you don't want ResourceEditor you can `cd spunk ; ${MAKE_E} lib`
+	cd ${WRKSRC}/spunk ; ${MAKE_E}
+	cd ${ESTIC} ; ${MAKE_E}
+
+do-install:
+	${INSTALL_PROGRAM} ${ESTIC}/xestic ${PBX_BIN}/
+	${INSTALL_DATA} ${ESTIC}/estic.res ${PBX_BIN}/
+	@# estic doc says estic.res must be in bin path or current directory
+	@${MKDIR} ${PBX_DOC}
+	${INSTALL_MAN} ${ESTIC}/estic.doc ${PBX_DOC}
+	@# estic.doc is not nroff format, & is in German, volunteers to create
+	@# _and maintain_ nroff formatted English should contact ${AUTHOR}
+	${INSTALL_MAN} ${FILESDIR}/README ${PBX_DOC}
+	@# files/README is not in nroff, but is a temporary document.
+	@${MKDIR} ${PBX_ETC} ${PBX_VAR}
+	${INSTALL_DATA} ${ESTIC}/estic.ini ${PBX_ETC}/estic.ini.generic_example
+	${INSTALL_DATA} files/estic.ini ${PBX_ETC}/estic.ini.freebsd_example
+	${INSTALL_DATA} ${ESTIC}/alias.dat ${PBX_ETC}/aliases.example
+	@# create config & debug so we can change mode to private
+	@touch ${PBX_ETC}/config ${PBX_VAR}/debug
+	chmod 600 ${PBX_VAR}/debug ${PBX_ETC}/config
+	chmod 700 ${PBX_VAR} # estic will create ./1996.11 etc
+
+post-install:
+	@echo ""
+	@echo " Suggestion, try:	make demo"
+
+demo:
+	@echo "If you want to try this under X-Windows, do this:"
+	@echo " setenv SPUNK_LANGUAGE 001"
+	@echo " setenv SPUNK_XFONT 8x13"
+	@echo " cd ${PBX_ETC}"
+	@echo " vi estic.ini"
+	@echo " chmod 666 /dev/cuaaX, or su"
+	@echo " ${ESTIC}/xestic -display :0"
+	@echo " (If you have no Istec 100[38] connected, append -n )"
+	@echo " A BUGS & PROBLEMS section exists in files/README == man estic_freebsd"
+
+# Ref. NO_CDROM= & NO_PACKAGE=
+# It is not necessary to prevent inclusion of source or binary on FreeBSD
+# CDROMs, # (despite the original German phraseology) as I (<jhs@freebsd.org>)
+# have obtained a waiver.  See files/README for explanation.
+
+.include <bsd.port.mk>
diff --git a/misc/estic/distinfo b/misc/estic/distinfo
new file mode 100644
index 00000000000..06a78d2f5cb
--- /dev/null
+++ b/misc/estic/distinfo
@@ -0,0 +1 @@
+MD5 (estic-1.40-sources.zip) = ed1c71e36e601a25b764cafa8df9bc2d
diff --git a/misc/estic/files/README b/misc/estic/files/README
new file mode 100644
index 00000000000..d4313e997fd
--- /dev/null
+++ b/misc/estic/files/README
@@ -0,0 +1,301 @@
+.nf \" This file gets installed as .../man/man1/estic_freebsd.1
+
+		NOTES ON ESTIC IN FREEBSD (/usr/ports/comms/estic/)
+		By Julian Stacey <jhs@freebsd.org> November 1996
+		 
+INDEX
+	1	EXAMPLE CONFIG FILE
+	2	C++ & FreeBSD VERSIONS
+	3	COPYING & USAGE RIGHTS
+	4	WEB REFERENCES FOR ISTEC PROTOCOL etc
+	5	SERIAL DC HANDSHAKING
+	6	PEOPLE WHO MAY BE INTERESTED IN THIS PORT
+	7	BUGS & PROBLEMS
+--------------------------------------------------------------------------------
+1   Example Config File
+=======================
+For /etc/pbx/estic.ini
+	[ESTIC]
+	SettingsFile    = "~/.estic-rc"
+	[Port]
+	PortName        = "/dev/istec"
+	[Printing]
+	Headline        = "Phone Bill"
+	[Windows]
+	ShowDateTime    = Minutes
+	ShowInfoOnStartup = no
+	[Call-Logs]
+	LogFile1 = "/var/log/pbx/%Y.%m
+	LogZeroCostCalls        = yes
+	[Alias]
+	AliasFile       = "/home/your_name/.estic-aliases"
+	AutoReadAliases = on            ; on/off/yes/no/1/0 mvglich
+	[Debug]
+	WaitAfterCall   = 500
+	DiagModeUpdate  = auto
+	DebugLog        = "/var/log/pbx/debug"
+	[Firmware]
+--------------------------------------------------------------------------------
+2   C++ & FreeBSD Versions
+==========================
+This package uses C++, which comes standard with FreeBSD.
+	uz@ says it's ok with FreeBSD 2.1.0 with g++ 2.6.3
+	jhs@ confirms it runs with src/ current (Oct 8 20:36 src-cur.2289.gz)
+	with c++ --version 2.6.3
+--------------------------------------------------------------------------------
+3   Copying & Usage Rights
+==========================
+Ref. Makefile NO_CDROM & NO_PACKAGE...
+
+There are somewhat restrictive conditions (in German) in the sources,
+which I've duplicated & translated ...
+
+  {--------
+  * Generic Original by "Ullrich von Bassewitz" <uz@ibb.schwaben.com>
+  + Generic Translation by "Julian H. Stacey"	<jhs@FreeBSD.org>
+  
+  Die ESTIC-Sourcen bzw. die ESTIC Binaries dürfen unter folgenden
+  Bedingungen weitergegeben werden:
+  The ESTIC sources & binaries may be distributed under the following conditions
+  
+    * Die Weitergabe geschieht im kompletten Paket mit Dokumentation.
+    + Distribution as complete package including documentation.
+  
+    * Die Weitergabe geschieht kostenlos. Dies bedeutet insbesondere,
+      daß ESTIC nicht ohne meine vorherige, schriftliche Genehmigung auf
+      CD-ROMS vertrieben werden darf, genauso sind Mailboxen/FTP-Server
+      ausgeschlossen, bei denen der Zugang zu den Daten nicht frei für
+      jedermann ist.
+    + Distribution to be free of charge, This means in particular,
+      that ESTIC may not without my prior written permission be sold on CD-ROMs,
+      neither may it be provided on mailbox systems or FTP servers that only
+      offer restricted non public access.
+  
+    * Es dürfen keine geänderten Sourcen weitergegeben werden. Die Weitergabe
+      von geänderten Binaries, sowie diffs zu den Sourcen ist hingegen
+      zulässig. Das soll keine Schikane sein, sondern nur verhindern, daß
+      mehrere verschiedene Versionen der Sourcen auf dem Netz verfügbar
+      sind, was zwangslaeufig mit unnoetigem Aufwand fuer mich verbunden ist.
+    + No changed sources may be distributed.  The distribution of changed
+      binaries & diffs to the sources is however allowed.
+     This is not intended as chicanery, but to hinder multiple availability
+     of multiple versions of source on the net, which would create excess work
+     for me.
+  
+    * Binaries, die durch Änderungen an den Sourcen erstellt wurden
+      unterliegen weiterhin den hier angegebenen Bedingungen, d.h. es ist
+      keine kommerzielle Verwertung oder ein kommerzieller Vertrieb ohne
+      meine vorherige, schriftliche(!) Zustimmung erlaubt.
+    + Binaries produced from changed sources come under these conditions,
+     .... no commercial value added ... sales ... allowed, without my prior
+     written agreement.
+  
+  Ansonsten bin ich durchaus gesprächsbereit, d.h. wer aus irgendwelchen
+  Gründen gegen eine der hier angegebenen Bestimmungen verstossen will, der
+  kann sich gerne an mich wenden.
+  ... I'm open to discuss proposed breaches of these requirements.
+  --------}
+
+  So I wrote & got a release...
+
+  {--------
+  From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
+  Subject: Re: FreeBSD Ports wrapper for Estic-1.30
+  To: jhs@freebsd.org
+  Date: Mon, 23 Sep 1996 19:15:16 +0100 (MET DST)
+  
+  > May we have your permission to put your unchanged generic distribution
+  > sources (ie currently estic-1.30.zip on the FreeBSD CD-ROMs please ?
+  > (FreeBSD is a non profit org. like X inc & FSF,
+  > but Walnut Creek (who provide a free host for our co-ordination,
+  > at http://www.freebsd.org 
+  > (& others occasionally) take snaps & release of FreeBSD
+  > & provide the whole sources + binaries of all src + ports
+  
+  No problem. You are allowed to do so. The paragraph you cited is thought to
+  help control who earns money selling my code, but I've no problems with that
+  in the case of freebsd cdroms.
+  --------}
+
+  {--------
+  From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
+  Subject: Re: istec 1008
+  To: jhs@freebsd.org
+  Date: Tue, 19 Nov 1996 09:41:14 +0100 (MET)
+  
+  > I lost (or filed obscurely) the earlier permission you gave me,
+  > for FreeBSD to store your sources & a packaged binary on the FreeBSD CD-Roms,
+  > maybe you could give me some words again please, which I'll embed straight
+  > in the wrapper & not loose this time ;-)
+  
+  I will change that in the next version anyway. So, you may distribute ESTIC
+  as you like, as long as you leave the archive files intact.
+  --------}
+
+--------------------------------------------------------------------------------
+4   References
+==============
+http://africa.geomic.uni-oldenburg.de/~joey/Linux/istec-befehle
+	Istec 1008 intern
+	Da das Interesse gro_ ist (meines auch), hier der etwas
+	aufbereitete Text. Vielen vielen Dank an Hergen Lehmann, der sich die  
+	M|he des Reverse-Engineering gemacht hat. <p>
+	From: HERGEN_LEHMANN@TBX.BerliNet.DE (Hergen Lehmann)
+
+http://www.schwaben.de/home/uz/istecprot.html
+	Urspr&uuml;ngliche Version des Textes von Hergen Lehmann.
+	Kleinere Erweiterungen/Korrekturen von Ullrich von Bassewitz.
+	Erweiterungen der Version 1.93/1.95 von Paul Barnard (Emmerich),
+	deutsche &Uuml;bersetzung von Ullrich von Bassewitz.
+	Weitere Tips und Hinweise von Norbert Richter (Autor von PMISTEC).
+
+http://www.symmetrix.ch/Public/janti/isdnfaq.html
+	Author: c.dura@atlantis.cl.sub.de
+	Frequently Asked Questions zu ISDN
+	Dieses FAQ versteht sich also Informationsquelle fuer ISDN Einsteiger
+
+http://africa.geomic.uni-oldenburg.de/~joey/Linux/isdn-istec-befehle.html
+	<h1>ISTEC 1008 intern</h1>
+	Da das Interesse gro&szlig; ist (meines auch), hier der etwas
+	aufbereitete Text. Vielen vielen Dank an <a 
+	href="mailto:Hergen_Lehmann@TBX.BerliNet.DE">Hergen Lehmann</a>, 
+	der sich die
+	M&uuml;he des Reverse-Engineering gemacht hat. <p>
+
+http://www.snafu.de/~drebert/istec.html
+	<HTML><HEAD><TITLE>Istec Firmenware</TITLE></HEAD>^M
+
+http://www.emmerich.com/telekom/links.htm
+	<title>Links zu Interessanten Pages</title>
+
+http://www.bestweb.com/intfun/jrs/euroinfo.html
+	EuroISDN Telekom-Tarife+Technik
+--------------------------------------------------------------------------------
+5	Serial DC Handshaking
+=============================
+
+From: AmIstec (another package) / CE-Istec.LiesMich
+  WICHTIGER HINWEIS ZU DEN NEUEN ISTEC-ANLAGEN MIT CE-ZEICHEN!!
+  =============================================================
+	 
+  Die neuen Istec-Anlagen mit CE-Zeichen funktionieren leider
+  nicht mehr ohne weiteres an Nicht-Dosen, weil Emmerich die
+  serielle Schnittstelle galvanisch von der Anlage entkoppeln
+  mu_te. Die f|r die Daten|bertragung erforderlichen Spannungen
+  werden daher einfach von von den DTR- und RTS-Leitungen  
+  bezogen. Dazu wird bei der Originalsoftware DTR auf logisch 1
+  und RTS auf logisch 0 gesetzt um so die negative bzw. positive
+  Spannung der Istec zur Verf|gung zu stellen.
+
+  Leider ist das gezielte Setzen einzelner Signalleitungen im
+  serial.device des Amiga nicht vorgesehen. Hier werden immer
+  beide Leitungen auf logisch 1 gesetzt.
+
+  Um die Spannungsversorgung trotzdem zu ermvglichen, kann man
+  einen Schnittstellenadapter basteln, der die erforderlichen
+  Spannungen von Pin 9 und 10 des Amiga-Ports auf die beiden
+  Signalleitungen umlegt. Nach einiger \berlegung und durch die
+  Mithilfe von Christian Buchner ist es mir aber gelungen zu
+  ermvglichen, da_ mit AmIstec auch die neuen Istec-Anlagen
+  ohne diesen Hardwarezusatz am Amiga betrieben werden kvnnen.
+  Dazu wird die DTR-Leitung direkt |ber die Hardware gesetzt,
+  soda_ die Istec genau das bekommt, was sie erwartet. Dieser
+  Patch wird durch den Tooltype CEPATCH aktiviert bzw. bei
+  einem CLI-Aufruf als Parameter mitgegeben. 
+
+From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
+To: jhs@freebsd.org
+Date: Thu, 14 Nov 1996 14:44:52 +0100 (MET)
+
+  Oliver von Bueren <ovb@swissmail.com> ... sent me changes a few days ago. His
+  changes are relative to version 1.40 and they seem to work for him. The only
+  change that was new for me, was a call to DTROff (a function of the serial
+  port class). If this is really needed (and he stated that he checked the
+  pins with a voltmeter), this means that there is an error in the serial
+  module. The DTR pin should be inactive if there is no hardware handshaking
+  enabled as is the case with ESTIC.
+  
+  
+  The only thing that was really new for me was the call to DTROff. I will
+  check the serial module, since this call cures a symptom and not the error
+  itself (but you may use it anyway).
+  
+  If you make any changes (apart from those in Oliver's diffs), I would like
+  to hear from it. I got a few mails from FreeBSD people and I would like to
+  incorporate any changes that make ESTIC work for FreeBSD into the main
+  release. This little work saves me lots of emails :-)
+--------------------------------------------------------------------------------
+6   People who may be interested in this port
+=============================================
+People who may be interested in this port as it evolves:
+	"Ullrich von Bassewitz" <uz@ibb.schwaben.com>,
+	"Oliver von Bueren"	<ovb@swissmail.com>,
+	"Julian H. Stacey"	<jhs@FreeBSD.org>,
+	"Peter Dieth"		<dieth@seicom.net>,
+	"Terry Lambert" 	<terry@cs.weber.edu>,
+	"Christian Kratzer"	<ck@toplink.de>,
+	"Torsten Blum"		<torstenb@tlk.de>,
+	"Greg Lehey"		<grog@lemis.de>,
+	"Robert Eckardt"	<roberte@mep.ruhr-uni-bochum.de>
+
+To give the FreeBSD `powers that be' confidence to commit this wrapper,
+I append a quote: (which can be deleted once the port is committed).
+
+> From: Robert Eckardt <roberte@mep.ruhr-uni-bochum.de>
+> Subject: Re: your mail
+> Date: Thu, 21 Nov 1996 01:51:23 +0100 (MET)
+>
+> ....
+> No, as stated above, it works fine now.
+> Just getting the 1.40 zip-file, applying the ports and changing the
+> config file was sufficient. 
+> Now you have another data point in the sets of working configurations.
+------
+> From: Robert Eckardt <roberte@mep.ruhr-uni-bochum.de>
+> Subject: Re: ESTIC
+> To: uz@ibb.schwaben.com
+> Date: Thu, 21 Nov 1996 10:55:36 +0100 (MET)
+> Cc: roberte@mep.ruhr-uni-bochum.de, jhs@freebsd.org, uz@ibb.schwaben.com
+> 
+> > /usr/X11 is usually a link to /usr/X11R6. I don't know if this is true with
+> > FreeBSD but most Linux distributions have it.
+> 
+> FreeBSD does not have it by default.
+> The X11 dir was changed in many other places in the makefiles, so may
+> be it would be a good idea to change it in the last place too.
+> In fact, one could use perhaps some make-var X11ROOT (don't know what's
+> standard).
+> 
+> Nevertheless, it's a graet port for a very useful program.
+
+--------------------------------------------------------------------------------
+7	Bugs & Problems 
+=======================
+- I have to start it as 	xestic -display :0	else I get
+  Internal error: ScrInit: Cannot open display, file xsrc/console.cc, line 898
+- When it starts I (jhs) get
+	Malloc warning: free(): junk pointer (too high)
+  but after that it runs fine.
+- Alt X does not exit properly.
+- Strange error messages if a file does not exist, 
+	First I get a nice error message:
+		Cannot open the alias file!
+	ESC
+	only then do I get the nasty one I remembered
+		Internal error: Call to abstract method (= 0)
+		file strmable.cc
+		line 46
+	Source shows:
+		void Streamable::Store (Stream&) const
+		{
+	  46	    ABSTRACT ();
+		}
+- Mouse cursor strangely converts to skull & crossbones.
+- Alt X does not exit properly.
+  UZ wrote:
+  > This is usually because of a wrong setting for the modifier keys. ESTIC
+  > uses Mod4 for Alt and Mod3 for Alt-Gr. Unfortunately, there is no standard
+  > modifier key mapping, not even for the x86 unices, which use the same
+  > keyboard layout.
+
+--------------------------------------------------------------------------------
diff --git a/misc/estic/files/estic.ini b/misc/estic/files/estic.ini
new file mode 100644
index 00000000000..16112bd49c3
--- /dev/null
+++ b/misc/estic/files/estic.ini
@@ -0,0 +1,237 @@
+; /etc/pbx/estic.ini used by Julian Stacey <jhs@freebsd.org>
+
+; I use these symbolic links:
+;	/usr/local/etc/pbx	--> ../../../etc/pbx
+;	/usr/local/var		--> ../../var
+; Ideas I've suggested to "Ullrich von Bassewitz" <uz@ibb.schwaben.com>:
+;         Maybe estic should look for estic.ini by default
+;         a)      in ~/estic-ini
+;         or maybe less preferably
+;         b)      as indicated by an environment variable.
+
+
+
+; ------------------------- ESTIC Grundeinstellungen ------------------------
+[ESTIC]
+
+
+; Das File in dem ESTIC seine Einstellungen speichert. Dazu gehören
+; sämtliche(!) Fenster, Positionen, Größen und ähnliches. Unter den *nix
+; Derivaten kann der Namen die Tilde als Ersatz für das Home-Verzeichnis
+; beinhalten (ein guter Name wäre z.B. "~/.esticrc").
+
+; Bei Problemen kann diese Datei ohne weiteres gelöscht werden, da sie
+; keine für ESTIC "lebenswichtigen" Daten enthält.
+; Die Defaulteinstellung ist "estic.rc", d.h. die Datei wird im aktuellen
+; Verzeichnis angelegt. Ist der Name leer (""), dann wird nichts gespeichert.
+
+; Default: "estic.rc"
+SettingsFile	= "~/.estic-rc"
+
+[Port]
+; Typically "/dev/cuaa3 on my host vector"
+; Typically "/dev/cuaa1 on my host gate"
+PortName	= "/dev/istec"
+
+[Printing]
+; String der als Kopfzeile verwendet wird
+Headline	= "Phone Bill"
+; Cost per charge unit, default is 12 Pf
+;PricePerUnit	 = 0.12
+
+; -------------------------------- Windows --------------------------------
+[Windows]
+
+; Bildschirm-Modus (nur für DOS & OS/2). Default ist die Verwendung des
+; aktuell eingestellten Modus.
+;
+; Folgende Modi sind verfügbar:
+;
+;   0		40x25, B/W		DOS, OS/2
+;   1		40x25, Farbe		DOS, OS/2
+;   2		80x25, B/W		DOS, OS/2
+;   3		80x25, Farbe		DOS, OS/2
+; 257		80x30, Farbe, nur VGA	DOS, OS/2
+; 258		80x34, Farbe, nur VGA	DOS, OS/2
+; 259		80x43, Farbe, nur VGA	DOS, OS/2
+; 260		80x50, Farbe, nur VGA	DOS, OS/2
+; 261		80x60, Farbe, nur VGA	DOS, OS/2
+; 262		94x25, Farbe, nur VGA	DOS
+; 263		94x30, Farbe, nur VGA	DOS
+; 264		94x34, Farbe, nur VGA	DOS
+; 265		94x43, Farbe, nur VGA	DOS
+; 266		94x50, Farbe, nur VGA	DOS
+; 267		94x60, Farbe, nur VGA	DOS
+; 298		100x40, nur ET4000	DOS
+; 512		"ask" - aktuellen Modus verwenden
+
+;VideoMode = 257
+
+
+; Soll in der rechten oberen Ecke Zeit/Datum permanent angezeigt werden?
+; Mögliche Werte:
+;	None	(keine Anzeige)
+;	Minutes (Stunden/Minuten)
+;	Seconds (auch Sekunden)
+; Default ist Minutes
+
+ShowDateTime	= Minutes
+
+
+; Soll direkt beim Start das Fenster mit den Informationen über die Istec
+; (Software-Version usw.) angezeigt werden?
+; Default ist yes
+ShowInfoOnStartup = no
+
+; ------------------------------- Call-Logs -------------------------------
+[Call-Logs]
+
+; Namen der Logfiles in die ESTIC ausgehende Gespräche loggt. Die angegebenen
+; Namen sollten einen Pfad enthalten und können u.a. Steuercodes für strftime
+; enthalten. Durch die Wahl des Namens kann z.B. ein Tages-, Wochen- oder
+; Monatslog erzeugt werden: Wenn der Name z.B. so gewählt ist, dass er sich
+; jeden Tag ändert, dann entsteht ein Tageslog. Die Namen sind nur Vorschläge -
+; speziell unter Linux und OS/2 bietet es sich an, längere Namen zu verwenden.
+;
+; Verwendet werden können:
+;
+;	%%	für das Zeichen '%'
+;	%a	Wochentag, kurz
+;	%A	Wochentag, lang
+;	%b	Monat, kurz
+;	%B	Monat, lang
+;	%c	Zeit+Datum (nicht zweckmässig)
+;	%d	Tag des Monats (01-31)
+;	%E	Apparat, von dem das Gespräch ausging (21-28)
+;	%H	Stunde (00-23)
+;	%I	Stunde (00-12)
+;	%j	Tag des Jahres (001-366)
+;	%m	Monat (01-12)
+;	%M	Minute (00-59)
+;	%p	AM oder PM
+;	%S	Sekunde (00-59)
+;	%U	Kalenderwoche, Sonntag erster Wochentag (00-53)
+;	%w	Nummer des Wochentags (Sonntag = 0)
+;	%W	Kalenderwoche, Montag erster Wochentag (00-53)
+;	%x	Datum
+;	%X	Zeit
+;	%y	Jahr, zweistellig (00-99)
+;	%Y	Jahr, vierstellig
+;
+; Achtung: Alle Bezeichner (für Monat, Tag usw.) sind englisch!
+;
+; Default ist für das Logfile1 die Datei "outgoing.log" im aktuellen
+; Verzeichnis, für die beiden anderen der Leerstring (d.h. kein Logging).
+; Für den Eintrag in das Logfile ist die Startzeit maßgeblich, d.h. die
+; Zeit zu der das Gespräch begonnen wurde.
+;
+; An ein Logfile wird prinzipiell immer angehängt wenn die Datei existiert,
+; ansonsten wird sie erzeugt. Ergibt sich aus den angegebenen Pattern
+; mehrfach derselbe Name, so wird in dieses File auch mehrfach geloggt.
+;
+
+;Logfile1 = "%d-%m-%y.log"	 ; Ergibt 01-08-95.log
+;Logfile2 = "KW%W-%y.log"	 ; Ergibt KW43-95.log
+;Logfile3 = "%m-%Y.log"		 ; Ergibt 12-1995.log
+;LogFile1 = "%b-%y.log"		 ; Ergibt Feb-95.log
+;LogFile2 = "%b-%y.%E"		 ; Ergibt Feb-95.21
+
+LogFile1 = "/usr/local/var/log/pbx/%Y.%m
+; creates files such as 1996.11
+
+
+
+; Angabe, ob Gespräche mit 0 Einheiten (z.B. wenn nicht abgehoben wurde)
+; geloggt werden.
+
+LogZeroCostCalls	= yes
+
+; Wie viele Stellen sollen am hinteren Ende der Nummer ausge-X-t werden?
+; Default ist 0.
+; ACHTUNG: Bei Werten > 0 können keine Aliase mehr aufgelöst werden, da
+; die Nummer im Aliasfile nicht mehr gefunden wird!
+
+;XDigits		 = 3
+
+
+; --------------------------------- Aliase --------------------------------
+[Alias]
+
+; Hier können Aliase für die einzelnen Anschlüsse vergeben werden. Diese
+; tauchen dann in den Logfiles neben den Nummern auf.
+;
+; Für das Eintragen der Aliase gibt es zwei verschiedene Möglichkeiten.
+;
+; * Direktes Eintragen hier im .ini File. Das ist nur für die eigenen Geräte
+;   möglich (d.h. die Nummern 21..XX), alle anderen Nummern werden ignoriert.
+; * Ein separates Alias-File. Dort können sowohl Aliase für die eigenen
+;   Geräte als auch für ausgehende Nummern aufgenommen werden.
+;
+; Die Unterscheidung erfolgt anhand der Variable "AliasFile". Ist hier ein
+; Name angegeben, dann werden nur die Aliase aus dieser Datei verwendet.
+; Ist kein Name für die Alias-Datei angegeben, dann wird versucht, die
+; Aliase für die eigenen Geräte aus der ini Datei zu lesen.
+
+; Die folgenden Einträge werden ignoriert, weil weiter unten eine Alias-Datei
+; angegeben ist. Es soll nur die Syntax gezeigt werden.
+;21	 =	 "Büro"
+;22	 =	 "Martin"
+;23	 =	 "Fax, Büro"
+;24	 =	 "Philip"
+;25	 =	 "Wohnzimmer"
+;28	 =	 "Anrufb."
+
+; Ein Aliasfile, das Namen für bestimmte Rufnummern enthält.
+; Default: "alias.dat"
+; AliasFile	= "/etc/pbx/aliases"
+; AliasFile	= "~/.estic-aliases"	; syntax fails ive reported it to uz
+AliasFile	= "/home/your_name/.estic-aliases"
+
+; Wenn AutoReadAliases auf on gesetzt ist, dann wird nach jedem Gespräch die
+; oben angegebene Alias-Datei neu eingelesen. Da das nur dann notwendig ist,
+; wenn sich das Aliasfile öfters ändert, ist der Default off, d.h. einlesen
+; nur auf explizite Anforderung in ESTIC. Der Schalter hat keine Wirkung,
+; wenn kein Aliasfile definiert ist.
+
+AutoReadAliases = on		; on/off/yes/no/1/0 möglich
+
+
+; ------------------------------- Debugging -------------------------------
+[Debug]
+
+; Zeit in ms, die nach dem Gespräch gewartet wird, bevor die Gebühren
+; abgefragt werden. Falls nach Gesprächen manchmal (oder immer) 0 Einheiten
+; geloggt werden, obwohl eine Verbindung zustande kam, diesen Wert vorsichtig
+; erhöhen.
+WaitAfterCall	= 500
+; I presume (& have asked "Ullrich von Bassewitz" <uz@ibb.schwaben.com> if)
+;        WaitAfterCall
+; will only succeed if one has a `Deutsche Telekom Komfort Anschluss'
+; & not a Deutsche Telekom Standard Anschluss'
+
+; Umschiffung eines Bugs in alten Istec Firmware-Versionen: Versionen bis hin
+; zur Version 1.93 schalten selbsttätig irgendwann den Diagnose-Modus ab, den
+; ESTIC zur Darstellung der Verbindungsmatrix und der Gesprächserfassung
+; benötigt. Soll der Diagnose-Modus in regelmäßigen Abständen von ESTIC
+; eingeschaltet werden? Mögliche Werte sind ON, OFF und AUTO, Default ist
+; AUTO (d.h. ON, wenn Firmware <= 1.93).
+DiagModeUpdate	= auto
+
+; Logfile für's Debugging, default ist der Leerstring
+DebugLog	= "/usr/local/var/log/pbx/debug"
+
+; -------------------------------- Firmware -------------------------------
+[Firmware]
+
+; Die unterschiedlichen Versionen der Istec Firmware unterstützen
+; unterschiedliche Features. Bei angeschlossener Istec erkennt ESTIC selber,
+; welche Version der Firmware verwendet wird. Sollen Konfiguratonsdateien
+; erstellt werden, ohne daß eine Istec angeschlossen ist, dann kann ESTIC
+; nicht erkennen, welche Firmware-Version vorhanden ist und stellt u.U.
+; bestimmte Einstellungen nicht zur Wahl. Mit der Variable FirmwareVersion
+; kann angegeben werden, welche Version ESTIC bei nicht angeschlossener
+; annehmen soll. Der Default ist Firmware Version 1.70.
+; Nochmal: Das hat nur eine Bedeutung, wenn _keine_ Istec angeschlossen ist.
+
+; jhs@ has 1.96
+; FirmwareVersion = 1.96
diff --git a/misc/estic/files/patch-aa b/misc/estic/files/patch-aa
new file mode 100644
index 00000000000..292f7028494
--- /dev/null
+++ b/misc/estic/files/patch-aa
@@ -0,0 +1,39 @@
+*** estic/make/freebsd-x.mak.orig	Sat Sep 21 17:37:54 1996
+--- estic/make/freebsd-x.mak	Sat Sep 21 17:49:09 1996
+***************
+*** 75,81 ****
+  all:	xestic
+  
+  xestic: $(LIB) $(OBJS)
+! 	$(CC) -o xestic $(OBJS) $(LIB) -ltermcap -lg++ -lX11
+  
+  
+  # ------------------------------------------------------------------------------
+--- 76,82 ----
+  all:	xestic
+  
+  xestic: $(LIB) $(OBJS)
+! 	$(CC) -L /usr/X11R6/lib -o xestic $(OBJS) $(LIB) -ltermcap -lg++ -lX11
+  
+  
+  # ------------------------------------------------------------------------------
+*** spunk/make/freebsd-x.mak.orig	Fri Jun 21 12:57:24 1996
+--- spunk/make/freebsd-x.mak	Thu Nov 21 23:01:13 1996
+***************
+*** 31,37 ****
+  
+  # Flags for the gnu compiler (use the second one for gcc >= 2.6.0)
+  #CFLAGS = -DFREEBSD -g -Wall -x c++ -I /usr/X11/include
+! CFLAGS	= -DFREEBSD -g -Wall -x c++ -I /usr/X11/include -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  LIB	= spunk.a
+  ZIPFILE = spunk.zip
+--- 31,38 ----
+  
+  # Flags for the gnu compiler (use the second one for gcc >= 2.6.0)
+  #CFLAGS = -DFREEBSD -g -Wall -x c++ -I /usr/X11/include
+! #CFLAGS	= -DFREEBSD -g -Wall -x c++ -I /usr/X11/include -fno-implicit-templates -DEXPLICIT_TEMPLATES
+! CFLAGS	= -DFREEBSD -g -Wall -x c++ -I /usr/X11R6/include -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  LIB	= spunk.a
+  ZIPFILE = spunk.zip
diff --git a/misc/estic/files/patch-ab b/misc/estic/files/patch-ab
new file mode 100644
index 00000000000..46bf1f8c648
--- /dev/null
+++ b/misc/estic/files/patch-ab
@@ -0,0 +1,50 @@
+# estic.doc
+# Mir ist mitgeteilt worden, daß die FreeBSD Version das Flag USE_OLD_TTY
+# braucht. Offenbar ist die Behandlung der RS232 Handshakeleitungen
+# geändert worden, die für die neue Platine der Istec (#3) benötigt
+# werden. Nähere Informationen liegen mir nicht vor, ich wäre dankbar,
+# wenn das nochmal jemand verifizieren könnte.
+
+# ovb@swissmail.com does not use -DUSE_OLD_TTY
+# neither does jhs@freebsd.org need it
+
+*** estic/make/freebsd-x.mak.orig	Sat Sep 14 15:40:16 1996
+--- estic/make/freebsd-x.mak	Mon Nov 18 03:08:27 1996
+***************
+*** 35,41 ****
+  # Both configurations of CFLAGS will probably work since FreeBSD has a
+  # smart linker...
+  #CFLAGS = -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -L /usr/X11R6/lib
+! CFLAGS	= -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -L /usr/X11R6/lib -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  
+  # ------------------------------------------------------------------------------
+--- 35,42 ----
+  # Both configurations of CFLAGS will probably work since FreeBSD has a
+  # smart linker...
+  #CFLAGS = -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -L /usr/X11R6/lib
+! #CFLAGS	= -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -L /usr/X11R6/lib -fno-implicit-templates -DEXPLICIT_TEMPLATES
+! CFLAGS	= -DFREEBSD -g -Wall -I$(INCDIR) -x c++ -L /usr/X11R6/lib -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  
+  # ------------------------------------------------------------------------------
+*** estic/make/freebsd.mak.orig	Sat Sep 14 15:40:16 1996
+--- estic/make/freebsd.mak	Mon Nov 18 03:08:31 1996
+***************
+*** 35,41 ****
+  # Both configurations of CFLAGS will probably work since FreeBSD has a
+  # smart linker...
+  #CFLAGS = -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++
+! CFLAGS	= -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  
+  # ------------------------------------------------------------------------------
+--- 35,42 ----
+  # Both configurations of CFLAGS will probably work since FreeBSD has a
+  # smart linker...
+  #CFLAGS = -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++
+! #CFLAGS	= -DFREEBSD -DUSE_OLD_TTY -g -Wall -I$(INCDIR) -x c++ -fno-implicit-templates -DEXPLICIT_TEMPLATES
+! CFLAGS	= -DFREEBSD -g -Wall -I$(INCDIR) -x c++ -fno-implicit-templates -DEXPLICIT_TEMPLATES
+  
+  
+  # ------------------------------------------------------------------------------
diff --git a/misc/estic/files/patch-ac b/misc/estic/files/patch-ac
new file mode 100644
index 00000000000..5b9a65ac60e
--- /dev/null
+++ b/misc/estic/files/patch-ac
@@ -0,0 +1,94 @@
+These were mailed to jhs@
+by uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
+They were titled:
+	Written by Oliver von Bueren, ovb@swissmail.com, 12-Nov-1996 
+	The following is only an addition to the ESTIC program, which is Copyright
+	by Ullrich von Bassewitz. It's free to integrate into ESTIC as long as
+	the terms for the original program from UvB are met.  
+	There is absolutely no guarantee that it will work on any other system,
+	it just works for me on my system.
+
+I Julian Stacey <jhs@freebsd.org> have tried compiling without the 
+	Port->DTROff ();
+patch & can confirm for Ullrich, it is necessary, without it, I get
+a communications timeout. Thanks Oliver.
+
+*** estic/devstate.cc.orig	Sat Sep 14 15:40:16 1996
+--- estic/devstate.cc	Tue Nov 12 20:11:06 1996
+***************
+*** 622,628 ****
+  	    if (DevNum + 21 == E.Info.U % 256) {
+  		if (GetState (stBusy) == 0) {
+  		    // Get the duration
+! 		    ForcedRingEnd = Time () + TimeDiff (E.Info.U / 256);
+  		    // Set the new state
+  		    SetState (stForcedRing | stForcedRingOn);
+  		    // Send the command to the istec
+--- 622,631 ----
+  	    if (DevNum + 21 == E.Info.U % 256) {
+  		if (GetState (stBusy) == 0) {
+  		    // Get the duration
+! // ovb@swissmail.com, 12-Nov-96: Added typecast (double) as the compiler 
+! //				 complained about ambiguous selection 
+! //				 possibilities for TimeDiff.
+! 		    ForcedRingEnd = Time () + TimeDiff ((double)E.Info.U / 256);
+  		    // Set the new state
+  		    SetState (stForcedRing | stForcedRingOn);
+  		    // Send the command to the istec
+*** estic/iccom.cc.orig	Sat Sep 14 15:40:16 1996
+--- estic/iccom.cc	Tue Nov 12 20:05:34 1996
+***************
+*** 34,39 ****
+--- 34,48 ----
+  #include "iccom.h"
+  
+  
++ /*****************************************************************************/
++ /*                      Explicit template instantiation                      */
++ /*****************************************************************************/
++ 
++ // ovb@swissmail.com, 12-Nov-96: This definition seemed to be missing.
++ #ifdef EXPLICIT_TEMPLATES
++ template class CircularBuffer<IstecMsg*>;
++ #endif
++ 
+  
+  /*****************************************************************************/
+  /*                                   Data                                    */
+***************
+*** 126,131 ****
+--- 135,144 ----
+      // Make the RTS line active. This is needed for the new PCB of the istec
+      // (beginning from version #3).
+      Port->RTSOn ();
++     // ovb@swissmail.com, 12-Nov-96: Fix of Rev3.
++     // We have to turn the DTR off as this is needed for the power supply.
++     // -> Power is taken from the RTS(+) and the DTR(-) line.
++     Port->DTROff ();
+  
+      // Success
+      return 0;
+***************
+*** 159,165 ****
+      // Post an appropriate event
+      PostEvent (evChargeUpdate);
+  }
+- 
+  
+  
+  static void IstecWrite (unsigned char* Msg, unsigned BufSize)
+--- 172,177 ----
+*** estic/icfile.cc.orig	Sat Sep 14 15:40:16 1996
+--- estic/icfile.cc	Tue Nov 12 20:06:33 1996
+***************
+*** 27,32 ****
+--- 27,35 ----
+  
+  #include "syserror.h"
+  
++ // ovb@swissmail.com, 12-Nov-96: This was missing to compile on FreeBSD 2.1.5
++ extern int errno;
++ 
+  #include "icfile.h"
+  
+  
diff --git a/misc/estic/pkg-comment b/misc/estic/pkg-comment
new file mode 100644
index 00000000000..3186f5f2742
--- /dev/null
+++ b/misc/estic/pkg-comment
@@ -0,0 +1 @@
+Controller for ISDN TK-Anlage (PBX, Private Branch Exchange) made by Istec
diff --git a/misc/estic/pkg-descr b/misc/estic/pkg-descr
new file mode 100644
index 00000000000..ac38cf597cd
--- /dev/null
+++ b/misc/estic/pkg-descr
@@ -0,0 +1,5 @@
+ESTIC is an Enhanced Supervisor Tool for ISTEC Configuration.
+The German manufacturer Emmerich makes Istec 1003 & 1008 TK-Anlagen.
+The TK-Anlage is an ISDN PBX ( Private Branch Exchange ).
+
+					Julian Stacey <jhs@freebsd.org>
diff --git a/misc/estic/pkg-plist b/misc/estic/pkg-plist
new file mode 100644
index 00000000000..a13650f8ae7
--- /dev/null
+++ b/misc/estic/pkg-plist
@@ -0,0 +1,9 @@
+bin/xestic
+bin/estic.res
+etc/pbx/estic.ini.generic_example
+etc/pbx/estic.ini.freebsd_example
+etc/pbx/aliases.example
+var/log/pbx/debug 
+etc/pbx/config
+share/doc/estic/README
+share/doc/estic/estic.doc