Content-type: text/html Manpage of hptutil

hptutil

Section: husky (1)
Updated: 1.4
Index Return to Main Contents
 

NAME

hptutil - a messagebase service utility for HPT. This program is part of the Husky Fidonet software project.  

SYNTAX

hptutil [-j] [-k] [-q] [-d] [-i <importlog>] link
hptutil [-j] [-k] [-q] [-d] [-i <importlog>] pack
hptutil [-j] [-k] [-q] [-d] [-i <importlog>] purge
hptutil [-j] [-k] [-q] [-d] [-i <importlog>] sort
hptutil [-j] [-k] [-q] [-d] [-i <importlog>] undel
hptutil [-q] [-d] fix (-s|-S) <msgbasepath>

where
importlog file with echoareas list for processing
msgbasepath Pathname of Squish messagebase without suffix .sqd
 

DESCRIPTION

hptutil is auxiliary program for fidonet message base maintenance. First, this program used for sorting messages by date. Second, for removing old messages. Third, for linking chains of messages for discussion threads. Four, for removing messages what marked for deletion. Fifthly, for fixing messagebases errors. hptutil reads a fidoconfig (husky configuration file), checks an importlog file (from fidoconfig or from command line) and process echoaread specified in this file. If importlog file is not exist or is't empty hptutil process all aread from fidoconfig. A fidoconfig pathname should be specified in the FIDOCONFIG enviroment variable, otherwize hptutil look file "config" in current directory. hptutil supports Jam and Squish messagebases formats, and for fix command - only Squish.  

COMMANDS

fix
Fix messagebase errors. New messagebase created with names like FixV1_09.sqd
link
if exist importlog file, linking only areas in this file, linking all areas if importlog not exist. The deletion of importlog subscribed in fidoconfig (and no deleted at all, if you use option -k). Linking all active messages in area.
pack
Packing msgbase, used function of renaming files, thats why Golded can't stay in reading areas, in this case may be problems (1st warning!). Squish packing didn't set umsgid=1 on first letter. No lastread changeing, but if umsgid = FFFFFFFF - this is will be wrong - not checked (2nd warning!). In Jam base first letter also non 1, no lastread changing, but if BaseMsgNum will be FFFFFFFF and then 0 lastread's will be damaged - not checked (3rd warning!). Reply chains not killed.
purge
Checked all keywords from fidoconfig (maybe I've forgoten something, but I tryed). From fidoconfig - keepUnread, killRead, purge, max. No packing, messages only "marked" as deleted. Reply chains not killed.
sort
If exist importlog file, sorting only areas in this file, sorting all areas if importlog not exist. File importlog not deleted. Sorting started from lastread, condition - date of the message. Reply chains is killed.
undel
Search messages marked for deletion and remove "delete" flag from these messages. If exist importlog file, process only areas in this file.

Working as separate modules, for example: hptutil purge
hptutil pack and with several command line options: hptutil sort link if you set several command line options, work will be not in this order, but first will be purge, then pack, sort, link.  

OPTIONS

-i <importlog>
-I <importlog>
Use alternate <importlog> file contains echoareas list for processing.
-j
Link Jam areas by CRC. This is fast but not accuracy method of linkage.
-k
Don;t remove importlog file.
-q
Quiet mode (don't output information messages to screen).
-d <level>
-D <level>
Set debug output level to "level".
-s <msgbasepath
-S <msgbasepath
Pathname of Squish messagebase without suffix .sqd
 

FILES

/etc/myprogram
/var/log  

ENVIRONMENT VARIABLES

FIDOCONFIG
Full pathname of the husky fidoconfig file.
 

EXAMPLES

To sort and link all echoes:

hptutil -i notexistent.file sort link

To sort and link echoesi with new messages you should specifies "importlog" in the fidoconfig and call hptutil after tosser immediately:

hpt toss; hptutil sort link

To purge only one echoarea you can run several command sequence:

echo FIDOSOFT.HUSKY > /tmp/file.tmp
hptutil -i file.tmp purge
rm /tmp/file.tmp

To fix Squish messagebase:

hptutil fix -s /fido/msgb/ru.husky
mv /fido/msgb/FixV1_09.sqd /fido/msgb/ru.husky.old.sqd
mv /fido/msgb/FixV1_09.sqd /fido/msgb/ru.husky.sqd
 

BUGS

hptutil pack may damage messagebase. Please backup the messagebase before packing.  

AUTHORS

Fedor Lizunkov 2:5020/960@fidonet
Max Levenkov <sackett@mail.ru>  

SEE ALSO

hpt(1), sqpack(1)

 

Index

NAME
SYNTAX
DESCRIPTION
COMMANDS
OPTIONS
FILES
ENVIRONMENT VARIABLES
EXAMPLES
BUGS
AUTHORS
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 18:51:33 GMT, July 08, 2022