Ivan Wills > Tail-Tool-v0.3.3 > tailt

Download:
Tail-Tool-v0.3.3.tar.gz

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source   Latest Release: Tail-Tool-v0.3.6

NAME ^

tailt - Tail files using the Tail::Tool library

VERSION ^

This documentation refers to tailt version 0.3.0.

SYNOPSIS ^

   tailt [option] file1 [ file2 ...]
   tailt --help | --man | --VERSION

 OPTIONS:
  file             This can be a local file or a remote file specified by an
                   ssh URI eg ssh://user@example.com:22//var/log/error.log
  -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

 PLUGINS:
  -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     Sets op the replace plugin option which chnages match values.
     --spacing key=value

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.

SUBROUTINES/METHODS ^

DIAGNOSTICS ^

CONFIGURATION AND ENVIRONMENT ^

~/.tailtrc

Stores the saved configuration options (stored in YAML format)

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.

syntax highlighting: