aereport -RePorT(1)

NAME
aereport -RePorT - report generator

SYNOPSIS
aereport [ option... ] report-name
aereport [ option... ] -File filename
aereport -RePorT -List
aereport -Help
aereport -VERSion

DESCRIPTION
The aereport command is used to generate reports from aereport' database. Reports are specified in a C-like language described in the aer(5) manual entry.

For a list of the reports available on your system, use the 'aer -list' command. These reports live in the /report directory, and it initially contains the reports distributed with aereport, however sites are free to add their own here.

WRITING REPORT SCRIPTS
Getting started writing report scripts can be difficult. You are best to have a look at the reports distributes with Aegis, and try to adapt them. The report script files are kept in the /report directory.

For information about the data structures which may be accessed from a report script, you need to see the relevant manual entries:

the projects list
    See aegstate(1) for the member fields.

a specific project
    See aepstate(1) for the member fields.

a specific change
    See aecstate(1) for the member fields.

a specific file
    See aefstate(1) for the member fields.

Each of the above man pages also contains a section towards the end which specifically addresses report generator use, usually with code fragments.

OPTIONS
The following options are understood:

-File filename
    Take the report script from the specified file, rather than looking for the named report in the library of reports distributed with . The filename “-” is understood to mean the standard input.

RECOMMENDED ALIAS
The recommended alias for this command is
csh%    alias aer 'aereport \!* -v'
sh$     aer(){aereport "$@" -v}

SEE ALSO

ael(1)
    list (possibly) interesting things

aer(5)
    report script language definition