This is the README file for InSyTrack (INter-SYstem TRACKing), a library
 and a server program that allows program flow tracking between
 programming languages, libraries or even different systems.

Author: Bogdan Drozdowski, bogdro \at\ users . sourceforge . net
License: LGPLv3+

================================================================

The binary version of InSyTrack is linked with the GNU C Library,
 licensed under the GNU LGPL:

Copyright (C) 1991,92,93,94,95,96,97,98,99,2000,2001,2002,2003,2004,2005,
 2006,2007 Free Software Foundation, Inc.

The GNU C Library is free software; you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published
 by the Free Software Foundation; either version 2.1 of the License, or
 (at your option) any later version.

The GNU C Library is distributed in the hope that it will be useful, but
 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
 License for more details.

You should have received a copy of the GNU Lesser General Public License
 along with the GNU C Library; if not, write to the Free Software Foundation,
 Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

================================================================

Requirements for compiling:

- a working C compiler (C++ compilers won't work due to variable casts)

- development package for the C library (like glibc-devel and glibc-headers)

- pthreads support

- the 'make' program

Type

	./configure

to configure the software for your system.

Type

	make

to compile the software.

Documentation comes complied (you can copy it right away), but can be changed
 and recompiled, if you have the 'makeinfo' program ('texinfo' package).

The public interface is compatible with SWIG (http://www.swig.org), so
 you can make native bindings to InSyTrack for any supported language.

Type

	make install

to install the software.

NOTE: 'make install' is NOT recommended. Create and install an RPM
 package instead, if possible (see below).

Type 'info insytrackd' (after installation) or 'info doc/insytrackd.info'
(before installation) to get help.

=======================================================

Syntax:

	insytrackd [options]

Command line options:

--background		Continue work in the background, if possible.
--connections <n>	Allow up to <n> connections waiting to be serviced.
			Default: 1000.
-h|--help		Print help
-l|--license|--licence	Print license information
--listen <addr>		Listen on the given address only. Default: 0.0.0.0
			(all addresses). Set --socket-type first if not using
			IPv4. This option is available only when your system
			has the capabilities to set this.
--port <n>		Listen on the given port (if applicable for the
			current socket type). Default: 6677. This option is
			available only when your system has the capabilities
			to set this.
--protocol <n>		Use protocol number <n> for the socket. Default: 0.
			See below.
--socket-domain <n>	Use socket domain <n> for the socket. Default:
			AF_INET (IPv4). See below.
--socket-type <n>	Use socket type <n> for the socket. Default: stream
			socket (TCP). See below.
-v|--verbose		Verbose output.
-V|--version		Print version number


For protocol numbers, socket types and domains, browse the *.h files in
/usr/include on Unix/Linux.

=======================================================

Building an RPM package:

1) copy the insytrack.spec file to $HOME/rpmbuild/SPECS
2) copy the source package insytrack-XX.tar.gz to $HOME/rpmbuild/SOURCES
3) type
        rpmbuild -ba $HOME/rpmbuild/SPECS/insytrack.spec
4) get the RPMs from $HOME/rpmbuild/RPMS/ and $HOME/rpmbuild/SRPMS

Building an RPM package (the old way):

1) copy the insytrack.spec file to /usr/src/redhat/SPECS
2) copy the source package insytrack-XX.tar.gz to /usr/src/redhat/SOURCES
3) type
	rpmbuild -ba /usr/src/redhat/SPECS/insytrack.spec
4) get the RPMs from /usr/src/redhat/RPMS/ and /usr/src/redhat/SRPMS

=======================================================

Translating to your language:

 Type `msginit -i insytrack.pot -o XX.po', substituting your
2-letter language code for 'XX' (e.g. 'de'). This requires the
'gettext' package installed. You can manually copy the file
insytrack.pot to XX.po and manually add the following header, if
you wish.
 In the resulting XX.po file you have to fill in all the fields
marked with capital letters in the header:

# YOUR LANGUAGE translations for insytrack package.
# Copyright (C) 2013-2022 Bogdan 'bogdro' Drozdowski
# This file is distributed under the same license as
# the insytrack package.
# YOUR FULL NAME <EMAILADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: insytrack 0.3\n"
"Report-Msgid-Bugs-To: bogdro@users.sourceforge.net\n"
"POT-Creation-Date: 2013-05-02 15:51+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"

The rest of the file will contain messages from the program. Translate
them all and send me the resulting XX.po file.

Translating the documentation:
- info: simply change the *.texi.in files
- man: Unpack the page and translate the resulting *.3 files.
