X TTTTUUUUAAAA((((1111LLLL)))) RRRReeeelllleeeeaaaasssseeee 3333....3333 ((((1111 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) TTTTUUUUAAAA((((1111LLLL))))
X
X
X
X NNNNAAAAMMMMEEEE
X TUA - The Uucp Analyzer
X
X SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
X ttttuuuuaaaa [ option ]
X
X DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
X The purpose of the _T_U_A utility is to produce a readable and
X complete analysis of the _H_o_n_e_y_D_a_n_b_e_e_r UUCP connections.
X This manual page describes the _T_U_A command line options and
X shortly explains its output.
X
X OOOOPPPPTTTTIIIIOOOONNNNSSSS
X To specify any of the options, you can use either the short
X form or the more mnemonic long form. In the latter case, you
X can abbreviate the name as long as it is unique. For more
X information on the long format, please refer to the _G_N_U
X _g_e_t_o_p_t package description.
X
X
X ----SSSS,,,, ++++nnnnoooo----ssssyyyyssss----rrrreeeepppp
X Do not print the ppppeeeerrrr SSSSyyyysssstttteeeemmmm rrrreeeeppppoooorrrrtttt. The default is to
X print it out.
X
X ----UUUU,,,, ++++nnnnoooo----uuuusssseeeerrrr----rrrreeeepppp
X Do not print the ppppeeeerrrr UUUUsssseeeerrrr rrrreeeeppppoooorrrrtttt. The default is to
X print it out.
X
X ----DDDD,,,, ++++nnnnoooo----ddddaaaaiiiillllyyyy----rrrreeeepppp
X Do not print the DDDDaaaaiiiillllyyyy rrrreeeeppppoooorrrrtttt. The default is to print
X it out.
X
X ----CCCC,,,, ++++ccccoooommmmmmmmaaaannnndddd----lllliiiissssttttssss
X Show also the command lists. It is off by default
X because it makes TUA very hungry of memory.
X
X ----OOOO,,,, ++++oooonnnnllllyyyy----ssssyyyysssstttteeeemmmm _S_Y_S_T_E_M
X Consider just system _S_Y_S_T_E_M in the reports. You can
X specify more than one of this option, so you can have
X TUA consider just those systems.
X
X ----mmmm,,,, ++++nnnnoooo----mmmmoooonnnntttthhhhllllyyyy----aaaacccctttt
X Do not output the last 12 months activity summary.
X
X ----hhhh,,,, ++++nnnnoooo----hhhhiiiissssttttoooorrrryyyy
X Do not output the history at the end of the reports.
X
X ----cccc,,,, ++++sssseeeeppppaaaarrrraaaatttteeee----ccccoooommmm
X Separate command lists from the other data. So there
X will be two tables with the header _B_y _S_y_s_t_e_m , the
X first containing only the amounts and the timing of
X each transfer, the second with all the commands invoked
X
X
X
X Page 1 (printed 9/1/91)
X
X
X
X
X
X
X TTTTUUUUAAAA((((1111LLLL)))) RRRReeeelllleeeeaaaasssseeee 3333....3333 ((((1111 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) TTTTUUUUAAAA((((1111LLLL))))
X
X
X
X by each System. You must specify also the ----CCCC option to
X make it works.
X
X ----kkkk,,,, ++++kkkkiiiillllllll----ssssyyyysssstttteeeemmmm _S_Y_S_T_E_M
X Eliminate each reference to _S_Y_S_T_E_M from the reports.
X Neither the transfer table nor the _S_Y_S_T_E_M command list
X will be printed.
X
X ----KKKK,,,, ++++kkkkiiiillllllll----uuuusssseeeerrrr _U_S_E_R
X Like ----kkkk , but it applies to the user called _U_S_E_R .
X
X ----HHHH,,,, ++++uuuuppppddddaaaatttteeee----hhhhiiiisssstttt
X Update the _h_i_s_t_o_r_y database (see the FILES section
X below) with the new values. You must have the uuuuuuuuccccpppp
X write permission.
X
X ----0000,,,, ++++rrrreeeesssseeeetttt----hhhhiiiisssstttt
X Reset the _h_i_s_t_o_r_y database, deleting any systems in it.
X Then put in the database the analysis since the last
X _u_u_c_l_e_a_n . You have to specify also ----HHHH to make this
X option do his job.
X
X ----yyyy,,,, ++++nnnnoooo----hhhhoooouuuurrrrllllyyyy----cccchhhhaaaarrrrtttt
X Do not display the hourly activity chart.
X
X ----zzzz,,,, ++++cccchhhhaaaarrrrtttt----ssssiiiizzzzeeee _S_I_Z_E
X Set the size of the hourly activity chart to _S_I_Z_E rows.
X The greater is this number, the smaller is the scale.
X By default it is set to 10.
X
X ----oooo,,,, ++++cccchhhhaaaarrrrtttt----oooonnnnllllyyyy
X Display only the hourly activity chart. Since with this
X options _T_U_A reads only ....AAAAddddmmmmiiiinnnn////xxxxffffeeeerrrrssssttttaaaattttssss, it is faster.
X
X ----vvvv,,,, ++++vvvveeeerrrrbbbboooosssseeee
X Print, on standard error, what is going on. While _T_U_A
X reads the various logs, it displays a counter of the
X loaded lines.
X
X ----pppp,,,, ++++pppprrrreeeeffffiiiixxxx----ppppaaaatttthhhh _P_A_T_H
X By default, _T_U_A looks for uucp data in ////uuuussssrrrr////ssssppppoooooooollll////uuuuuuuuccccpppp////
X and in the relative subdirectory. For debugging
X purpose, this option lets you change this directory, so
X that _T_U_A looks for the data in the specified _P_A_T_H.
X Below this point _T_U_A needs a hierarchy like the
X standard one (see FILES below).
X
X ----iiii,,,, ++++hhhheeeellllpppp
X Show a summary and a description of all the options.
X
X OOOOUUUUTTTTPPPPUUUUTTTT
X All reports are printed on the standard output, so you can
X
X
X
X Page 2 (printed 9/1/91)
X
X
X
X
X
X
X TTTTUUUUAAAA((((1111LLLL)))) RRRReeeelllleeeeaaaasssseeee 3333....3333 ((((1111 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) TTTTUUUUAAAA((((1111LLLL))))
X
X
X
X easily redirect them wherever you want. Assuming, unless
X otherwise stated, that you do not explicity request to
X disable some of the reports (eg. when you do not specify any
X command line option), here is a short description of what
X you get.
X
X BBBByyyy SSSSyyyysssstttteeeemmmm
X
X With this report, you get all the information relative to
X all the nodes that talk with your machine but those which
X didn't sent or received something. The data are divided in
X _i_n_b_o_u_n_d and _o_u_t_b_o_u_n_d. For each system, displayed in
X alphabetical order, you have the total count of the files
X transferred, with the relative bytes and times, as well as
X an average transfer rate (ATP). If ++++ccccoooommmmmmmmaaaannnnddddssss----lllliiiissssttttssss was
X specified, next there is the list of the commands invoked by
X that node, or directed to it. If a command is preceeded by a
X number between brackets, that number indicates how many
X times that command was invoked.
X
X BBBByyyy UUUUsssseeeerrrr
X
X This report is similar to the previous one, but it shows, in
X alphabetical order for each local user, all the commands the
X user invoked, and the transfers he caused.
X
X BBBByyyy DDDDaaaayyyy
X
X This report summarize the per day activity on the local
X machine. It doesn't depend on the destinations and on the
X users.
X
X SSSSUUUUMMMMMMMMAAAARRRRYYYY bbbbyyyy SSSSyyyysssstttteeeemmmm
X
X It shows a summary of the activity of each system, and the
X number of calls (inbound and outbound) for it. Please note
X that sometimes _T_U_A fails in calculating the exact number of
X calls, because of the misleading log of uucico. Note also
X that the "total connection time" always differs from the sum
X of the trasmissions times, because it takes care also of the
X various uucp dead time. In fact, it is calculated from the
X difference between the time in which the nodes are really
X connected (ie. at the end of dial phase, when the modem
X answers) and the time in which the link is dropped, due to
X the the end of the conversation as well as to any error.
X Then comes the time of the last connection with that system.
X There is also the subdivision of the connection time based
X on the phone costs, ie "day", "evening", "night". This is
X completely configurable, so if your telephone company uses a
X different hourly division you can adjust it (see ccccoooonnnnffffiiiigggg....hhhh
X and pppphhhhoooonnnneeeesssswwww....cccc.)
X
X
X
X
X Page 3 (printed 9/1/91)
X
X
X
X
X
X
X TTTTUUUUAAAA((((1111LLLL)))) RRRReeeelllleeeeaaaasssseeee 3333....3333 ((((1111 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) TTTTUUUUAAAA((((1111LLLL))))
X
X
X
X SSSSUUUUMMMMMMMMAAAARRRRYYYY bbbbyyyy SSSSyyyysssstttteeeemmmm ((((ttttaaaabbbblllleeee ffffoooorrrrmmmmaaaatttt))))
X
X Substancially, this report summarizes some of the previous
X informations in a tabular form. Nothing new...
X
X aaaannnndddd ssssiiiinnnncccceeee ............
X
X This is the historical data maintained by _T_U_A. It looks like
X the previous table, but it includes the history of the
X system, incrementally.
X
X LLLLaaaasssstttt 11112222 MMMMoooonnnntttthhhhssss AAAAccccttttiiiivvvviiiittttyyyy
X
X This table shows the activity of the local machine during
X the last 12 months. Only the transferred amounts are
X computed.
X The months are displayed in a manner so that the last column
X contains the current one, so it is very readable (of course,
X it is a matter of opinions!)
X
X HHHHoooouuuurrrrllllyyyy AAAAccccttttiiiivvvviiiittttyyyy ((((ppppeeeerrrr ccccoooommmmmmmmuuuunnnniiiiccccaaaattttiiiioooonnnn ppppoooorrrrtttt))))
X
X This chart shows the uucp hourly load for each used
X communication port. Each hour is divided in 20 minutes
X slices.
X
X GGGGlllloooobbbbaaaallll HHHHoooouuuurrrrllllyyyy AAAAccccttttiiiivvvviiiittttyyyy
X
X The same as the previous chart, but it reports the sums of
X all the ports.
X
X HHHHIIIISSSSTTTTOOOORRRRYYYY
X _T_U_A maintains a database with the history of each system and
X of the activity in each of the last 12 months activities. It
X is usually located in ////uuuussssrrrr////ssssppppoooooooollll////uuuuuuuuccccpppp////....AAAAddddmmmmiiiinnnn////ttttuuuuaaaa....hhhhiiiissssttttoooorrrryyyy and
X it is actually an ASCII file. It is up to you to update it
X or not, because probably you will like to run _T_U_A simply to
X have a notion of what is going on. To make it working
X correctly, you have to run _T_U_A with the option ++++uuuuppppddddaaaatttteeee----hhhhiiiisssstttt
X just before you run uuclean. So probably you will have to
X modify that script including in it a line like
X
X tua +update-hist {whatever options you like} | mail lele
X
X before it cleans up the uucp logs.
X
X BBBBUUUUGGGGSSSS
X Since HDB-Uucp doesn't put a complete datestamp in its logs,
X but omits the year, it may be possible that _T_U_A fails to
X compute the various times in the first analysis of the year.
X This is in my opinion its major weakness. For this
X silliness, _T_U_A cannot correctly handle logs that cover
X
X
X
X Page 4 (printed 9/1/91)
X
X
X
X
X
X
X TTTTUUUUAAAA((((1111LLLL)))) RRRReeeelllleeeeaaaasssseeee 3333....3333 ((((1111 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 1111999999991111)))) TTTTUUUUAAAA((((1111LLLL))))
X
X
X
X several years. There is little that I can do to correct the
X situation; I tried to adjust the year when the to-be-parsed
X date refers obviously to the previous year, but this is just
X a work-around...
X
X There is a limit: if your system spent more than 9999 hours
X linked with someone (or the sum exceed that value), the
X reports will be garbaged...
X
X DDDDIIIISSSSCCCCLLLLAAAAIIIIMMMMEEEERRRR
X _T_U_A is ffffrrrreeeeeeee, and it is redistribuitable under the terms of
X the GNU General Public License. You can find a copy of it in
X the file CCCCOOOOPPPPYYYYIIIINNNNGGGG in the distribution package. I reject any
X responsability about it. It is simple and safe, but I did
X not try it under all the possible conditions and
X environments, so if it causes you some trouble, I'll be sad
X for a while, but that's it. However, I will try to correct
X any bugs you will tell me.
X
X And pppplllleeeeaaaasssseeee,,,, forgive my poor english, but I put my soul in
X it...
X
X AAAAUUUUTTTTHHHHOOOORRRR
X Lele Gaifas, Idea Informatica, Rovereto (TN) - Italy
X ( piggy@idea.sublink.org )
X
X FFFFIIIILLLLEEEESSSS
X .../.Log/uucico/* uucico's logs
X .../.Log/uucp/* uucp's logs
X .../.Log/uux/* uux's logs
X .../.Log/uuxqt/* uuxqt's logs
X .../.Admin/xferstat Transfer stats
X .../.Admin/tua.history TUA's system history
X
X BBBBUUUUGGGGSSSS RRRREEEEPPPPOOOORRRRTTTT TTTTOOOO
X Lele Gaifas, piggy@idea.sublink.org
X
X AAAACCCCKKKKNNNNOOOOLLLLEEEEDDDDGGGGMMMMEEEENNNNTTTT
X I want to thank expecially Marco Lorenzini
X (marlor@gear.sublink.org) for his help in debugging the
X previous releases of _T_U_A on the SCO Unix architecture, and
X for his suggestions on the layout of the reports. And to the
X "omnipresent" Paolo Ventafridda (venta@i2ack.sublink.org)
X for his support and interest, and several other people that
X encouraged me to add more and more functionality, or that
X let me scan their huge logs.
X Thanks also to all the people that, with their PD or GPL
X software, helped me indirectly with ideas or examples.
X
X
X
X
X
X
X
X Page 5 (printed 9/1/91)
X
X
X
SHAR_EOF
chmod 0664 tua.1l ||
echo 'restore of tua.1l failed'
Wc_c="`wc -c < 'tua.1l'`"
test 17344 -eq "$Wc_c" ||
echo 'tua.1l: original size 17344, current size' "$Wc_c"
fi
exit 0
exit 0 # Just in case...
--
Kent Landfield INTERNET: kent@sparky.IMD.Sterling.COM
Sterling Software, IMD UUCP: uunet!sparky!kent
Phone: (402) 291-8300 FAX: (402) 291-4362
Please send comp.sources.misc-related mail to kent@uunet.uu.net.
