futility(1)

NAME
futility - the FEddi MsgBase-Utility

SYNOPSIS
futility link [AREAS]

futility pack [AREAS]

futility rescan [AREAS]

futility tool ACTION EXPRESSION [AREAS]

futility copy FOCUS TARGET [AREAS]

futility deldupes [AREAS]

futility addmsg [AREA]

futility info [AREAS]

futility nllookup STRING

DESCRIPTION
futility is a MsgBase-Utility for the FEddi-MsgBase-Format. The utility consists of seven subparts.

Status information goes to the LogFile and to STDERR.

futility returns 0 if no error occured, 1-99 idicates error. An errorlevel of 100 or more indicates that something was done (and that there was no error).

OPTIONS

--config|-c FILE
    reads rc from FILE

--force|-f
    force operation on area even if not neccessary

--quiet|-q
    suppress output to stderr. this will be automatical activated by tool-actions list and display

--message-format|-m STRING
    change format of tool-action display. use h for header, t for text and k for kludges

--list-format|-l STRING
    change format of tool-action list. format values: %f from, %F from address, %t to, %T to address, %s subject, %n number, %d date, %D received.

AREAS
The optional AREAS parameter specifies which areas to process. The case is ignored. A '+' specifies a section of areas. i.e. if you have a seperator called '----TrekNet----' then a parameter like '+trek' will select all areas after the seperator up to the next seperator or to the end. If you leave this param out, all areas will be selected. To exclude some areas use a '-AREA' before the name of the area. To exclude a section of areas use '-+SECTION'.

PACK
The pack function scans the specified AREAS for deleted messages and removes them from the MsgBase. Use +f switch to force link or pack.

LINK
The link function links the messages in the specified AREAS.

RESCAN
The rescan utility resets all counts for the AREAS. This may help you if bad handling (or a bug :-) genarates false counts for PRIVATE and DELETED flags.

TOOL
This function is a mighty manipulation tool for the msgbase. It allows you to set header-flags in conjunction to certain other values.

ACTION
    A list of [+ | - | *] [mark | delete | personal | protect | new | newpersonal | [FLAG]+ | list | display] seperated by commas. Example: "+mark,-protect". Legend: '+' == set, '-' == reset, '*' == toggle. list show a line for each selected message. The format of this line can be changed with the --list-format switch. Format values: %f from, %F from address, %t to, %T to address, %s subject, %n number, %d date, %D received. display displays the selected messages. The --message-format option controls which parts of the message will be printed (possible values: h header, t text, k kludges).

EXPRESSION
    EXPR[[|| | &&]EXPR]* (the operators '||' and '&&' will be precessed in order!)

EXPR
    all[+|-], mark[+|-], delete[+|-], personal[+|-], protect[+|-], new[+|-], newpersonal[+|-], number[<|<=|=|<>|>=|>]NUM, date[<|<=|=|<>|>=|>]DD.MM.YY, keep[+|-]NUM, age[+|-]DAYS, from[+|-]REGEX, to[+|-]REGEX, subject[+|-]REGEX, text[+|-]REGEX, attribute[+|-][FLAG]+, #marked[<|<=|=|<>|>=|>]NUM, #deleted[<|<=|=|<>|>=|>]NUM, #personal[<|<=|=|<>|>=|>]NUM, #protected[<|<=|=|<>|>=|>]NUM, #new[<|<=|=|<>|>=|>]NUM, #newpersonal[<|<=|=|<>|>=|>]NUM. The '+' counts as set or match, the '-' as notset or nomatch.

REGEX
    This represents a posix extended grep syntax regular expression as defined in regex.h and the regex info (see also fmbedit regex help page).

FLAG
    [pr|cr|rc|se|fa|it|or|ks|lo|hp|fr|rr|ir|ar|fu] . (pr=private, cr=crash, rc=received, se=sent, fa=fileattached, it=intransit, or=orphan, ks=kill/sent, lo=local, hp=hold, fr=filerequest, rr=returnreceiptrequest, ir=isreceipt, ar=auditrequest, fu=fileupdaterequest)

TOOL EXAMPLES
Delete all msgs older than 30 days in LINUX.GER: futility tool "+delete" "age+30" LINUX.GER Clean all areas and keep only the last 200 Msgs: futility tool "+delete" "keep+200" Delete all msgs in BLUBBER.1102 from 'Marcel R. Ackermann': futility tool "+delete" "from+marcel r. ackermann" BLUBBER.1102 List all msgs in NETMAIL from Zone 242 (notice: from and to include the address in bracets): futility tool "list" "from+\(242:" NETMAIL Protect and unnew all msgs in LINUX.GER which are marked and from or to 'Graf': futility tool "+protect,-new" "from+graf||to+graf&&mark+" LINUX.GER Export all messages about miro CRYSTAL 20SD to the file mcryst: futility tool display "subject+miro crystal 20sd" | formatmsg > mcryst

COPY
Copys all FOCUS msgs to TARGET.

DELDUPES
Deletes all duplicate msgs and packs the areas searched.

UPDATE
Updates areas with wrong version to current version (and format) without the loss of any data.

ADDMSG
Takes input from stdin as formattet messages and puts them into the MSGBASE. Could be used to automatical generate messages. If AREA is omitted the #Area entry of the message header (see FORMAT-OUTPUT in doc/) is used.

INFO
Pipes area info of specified areas to stdout. Always QUIET.

NLLOOKUP
Searchs for STRING in nodelist. You can enter an address or name. Always QUIET.

FILES

~/.feddirc
    for PATHS and PROFILE

SRCPATH/doc/FORMAT-OUTPUT-*
    for output format

MSGBASEPATH/areas
    for areas

SEE ALSO
fscan(1), ftoss(1), fmbedit(1), fnlc(1), feddirc(1)

AUTHOR
Oliver Graf.