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: 05:21:16 GMT, February 13, 2021