NAME
tailt - Tail files using the Tail::Tool library
VERSION
This documentation refers to tailt version 0.4.8.
SYNOPSIS
tailt [option] file1 [ file2 ...]
tailt --help | --man | --VERSION
FILES:
Specify one or more local or remote files to tail:
local specify local file (relative ./file, absolute /dir/file)
scp Specify files (similar to vim) scp://[user@]host:[port](file/relative/to/home/dir|/absolute/file)
ssh Specify files with ssh ssh://[user@]host[:port]/file
OPTIONS:
-r --restart Turn on menu, which allows chnaging of options/files/plugin
configuration on the fly. To see the menu type any thing
other than q and press enter, typing q & enter quit.
-n --lines=int The number of lines form the end of a file to start tailing
The default is 10.
-c --config=str Use the str config option from previously save config
--no_inotify Inotify works wonderfully usually but if a file is on a network
networked drive it sometimes doesn't fire when a tailed file
changes, this option turns off inotify and uses the polling
option
-d --disable=file
Add the file to the list of files but don't automatically
start tailing it. This can be specified more than once for
multiple disabled files or comma/semi-comma seperated
-v --verbose Show more detailed option
--VERSION Prints the version information
--help Prints this help information
--man Prints the full documentation for tailt
PLUGIN OPTIONS:
-h --highlight Sets up the hightlight plugin options
-m --match Sets up the match plugin option to only show lines that natch
the regexp.
-i --ignore Sets up the ignore plugin options to hide all lines that
match the regexp.
-r --replace key=value
Sets op the replace plugin option which chnages match values.
Keys:
regex A regular expression to match log line content
replace A string to replace the contents matched above
--spacing key=value
Add spacing when no new lines have occured for a period
of time
Keys:
times he time in seconds since last seen output (comma separated list of times)
lines he number of lines to show for the matching time (also comma separated list)
--grouplines key=value
Controls the way lines are processed. If used this can
allow you to control when a line is considered to start
for example if you log file occasionally out puts messages
that span several lines this can be used to group the
lines back before (for example) using the highligh plugin.
Keys:
regex A regular expression to match log line content
end How to treat line ends? (Bool 0 or 1)DESCRIPTION
Files
You can specify local files either relatively or absolutely. Remote files uses a vim like syntax for specifying remote files, it uses the ssh protocol which may mean that you may have issues if you don't use ssh keys. The format for the URI is:
ssh://[user@]host[:port]/(home/relative/file|/absolute/file)Note if you want a absolute file location you must have two slashes at the start of the path. One slash means that the file is relative to the user that you are logging in as.
Config
SUBROUTINES/METHODS
DIAGNOSTICS
CONFIGURATION AND ENVIRONMENT
DEPENDENCIES
INCOMPATIBILITIES
BUGS AND LIMITATIONS
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gamil.com).
Patches are welcome.
AUTHOR
Ivan Wills - (ivan.wills@gamil.com)
LICENSE AND COPYRIGHT
Copyright (c) 2010 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW, Australia, 2077). All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic. This program 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.