[go: up one dir, main page]

File: README

package info (click to toggle)
lwatch 0.4.1-2
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 716 kB
  • ctags: 346
  • sloc: sh: 3,376; ansic: 912; lex: 312; makefile: 97
file content (119 lines) | stat: -rw-r--r-- 4,540 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
$Id: README,v 1.26 2004/08/14 15:19:02 arturcz Exp $
$Source: /cvsroot/lwatch/files/README,v $

Log Watcher - tool for log watching and colorize.
http://sf.net/projects/lwatch/

Installation procedure: see INSTALL
Bug reporting: see BUGS
Feature request: see TODO.

Regular expression support is provided by the PCRE library package,
which is an open source software, written by Philip Hazel, copyright
by the University of Cambridge, England.

PCRE library is available at:
ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This package uses autotools. You can change all paths and directories
running configure with proper options.
Path and directories changes should be propagated into documentation
and binary. If not, please submit a bug (see BUGS for details).

If you want to use CVS snapshot please read README.cvs.
Automake 1.8 is not necessary. You may safely ignore messages about the 
lack of it as long as Makefile.am, acinclude.m4 and configure.ac are not
modified.

Log Watcher uses getopt_long function. Some unices have it included
in libc (specially glibc based ones), some have it in other libraries
and some do not have it. If you use one of the two last flavors of 
unices, please inform me how you compiled/linked lwatch.

In most cases (assuming, that you have the required libriaries)
    ./configure
    make
    make install
should work. If not, you can set following environment variables:
 - CPPFLAGS specifies additional directories where headers files are searched
 - LDFLAGS specifies additional directories where libraries are searched
 - LIBS specifies additional libraries which lwatch should be linked with

If you have includes/libraries in non-standard directories there are two cases.
1) Header files are in /any/directory/include and libraries are in /any/directory/lib
   In this case just add --with-libFOO=/any/directory to ./configure, for example:
   ./configure --with-libpcre=/opt
2) Above is not true. Then you should specify proper directories manually with CPPFLAGS
   and LDFLAGS, for example
(for example):
   ./configure CPPFLAGS="-I/opt/include" LDFLAGS="-L/opt/lib" 

If you have non-standard library which contains (i.e.) getopt_long run:
./configure LIBS="-lgnugetopt"

Set also CPPFLAGS and LDFLAGS if needed

Default input file is /dev/lwatch. You can change it running:
configure --enable-input=/other/file
What do you think about adding proper entries into syslog/syslog-ng
configuration file during package installation?

If you add this piece of software into any distribution as a package do me
a favour and, please, send me an email notice about it. You can find my email
address in AUTHORS file.

============================================
Flex errors
============================================
If you get an error like:
"yparse.l", line 1: unrecognized '%' directive
"yparse.l", line 2: bad character: #
"yparse.l", line 2: unknown error processing section 1
"yparse.l", line 2: unknown error processing section 1
"yparse.l", line 2: bad character: "
"yparse.l", line 2: unknown error processing section 1
"yparse.l", line 2: bad character: .
"yparse.l", line 2: unknown error processing section 1
"yparse.l", line 2: bad character: "
"yparse.l", line 3: bad character: }
that means you have too old flex. Please upgrade before compilation.
2.5.31 works for me.

============================================
OS specific information
============================================

* Cygwin
Bartek Tomicki told me that lwatch compiles and runs on cygwin without any
problemes. You can contact him at xinu@blabluga.hell.pl

* FreeBSD
Install libgnugetopt (1.2 works for me)
Use `gmake' instead of `make'

* Linux on i386
No additional packages required.

* Linux on other architectures
No experiences. Feedback mostly welcomed.

* Solaris - not tested
Read following resources:
http://sources.redhat.com/ml/automake/2000-08/msg00013.html
http://sunfreeware.com/programlistsparc8.html#libiberty
install libiberty and try:
LIBS="-liberty" CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib" ./configure
LIBS="-liberty" CPPFLAGS="-I/usr/local/include" LDFLAGS="-L/usr/local/lib" make
make install
and, please, notify me if it works.

* MS Windows
There is no native Windows port for lwatch. If you want to use it under MS Win
install Cygwin from http://www.cygwin.com/ and read a note about Cygwin in this
README.

* Other OS
I have no shell access to any other platforms. Any feedback about compiling
and running lwatch on them is greatly appreciated.

vim:tw=78: