GETRECENT

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ENVIRONMENT
FILES
EXAMPLES
AUTHOR
REPORTING BUGS
COPYRIGHT
SEE ALSO

NAME

getrecent - return list of recent database changes

SYNOPSIS

getrecent docno=Dn | docno=Fn [mode=L|mode=C] [filter=NVLS] [fields=DFCWNV] [password=PASSWORD] [max=n] [target=TARGET] [-database DATABASE]

DESCRIPTION

getrecent is a tool that queries the NOAH Documentation Database log files for recent changes and filters and selects which directory or file number to search and report on.

There may be a wrapper script in /usr/bin with noah- prefix that calls this program in the correct run directory.

The user has lots of control of what log file fields are tested and what file or directory data fields to report recent activity.

NOTE that a variation of this program is used in the web interface to give info on recent directory changes.

OPTIONS

getrecent docno=Dn or Fn [ mode=L | mode=C ] [ filter=NVD ] [ fields=DFCWNV ] [ password=PASSWORD ] [ max=n ] [ -database DATABASE ] [ target=TARGET ]

docno=Dn or Fn
Specify which directory or file nOmber (n) you want to query for recent changes in the log file.

[ filter=NVD ]
Decide what to look for. Each letter stands for a different type of database change in the NOAH database log file. Letters can be in any order and they are defined as follows:

N : new file upload or directory creation
V : new version upload
D : default version changed

Default is NVD.

[ fields=DFCWNV ]
This option specifies what fields to display. The letters can be in any order but the order defines the line print order.

Letters are defined as follows:

D   : Date of log entry
F   : Filename or directory name in log
C   : Change entry (description)
W   : Who made the change (username)
N   : Document number (Fn or Dn)
V   : Version number affected.

Default is DFCWNV.

-database DATABASE
Set the database to DATABASE. The default is default.

-h
quick help (usage)

-help
verbose help (this file)

ENVIRONMENT

This program is found in the admin directory and expects to be run from there.

In a Debian distribution, this program has a link to the wrapper program in the admin directory typically /usr/lib/noah/admin and the link name has a noah- prefix and is found in /usr/bin.

FILES

/usr/bin/getrecent

This is a link to wrapper

/usr/lib/noah/admin/wrapper

This is a generic bash shell wrapper to start the program in the admin directory.

/usr/lib/noah/admin/getrecent

This is the actual executable called by the wrapper.

/usr/lib/noah/database.config

This is typically a link to /etc/noah/database.config in a Debian release.

EXAMPLES

getrecent docno=D2 fields=DFWC mode=L

COUNT=1 2012 Nov 26 10:24:18;cameron.jpeg;admin;upload new file;

In the above example, we report on recent activity in D2 and see that the file cameron.jpeg was uploaded by user=admin.

AUTHOR

Harold Blount - Nordicwind Inc. www.nordicwind.ca

REPORTING BUGS

http://noah.@nordicwind.ca

COPYRIGHT

This is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 or later <http://gnu.org/licenses/gpl.html>.

This software is distributed WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.