.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "SIGIT 1" .TH SIGIT 1 "2001-03-11" "Amusements" "By Kenneth 'Redhead' Nielsen" .SH "NAME" sigit \- A tool to create random signatures. .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& sigit [-a file] [-r file] [-l file] [-u ident] [-cdevV] .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" You know when you have been having your signature for too long, then it needs replacement, but what if you get tired of manualy having to come up with alot of new signatures all the time. These problems are no longer required, sigit will handle it for you. You decide how long you like to wait, untill the signature is changed, you can run it as a cron job, or as a deamon running in the background even when your not loged in on the system. The default running mode is probably the most appreciated, it is running as a normal process, and will be killed when you logout. .PP It is uptimized for beeing used on a system with alot of users, where the executable will be located for any user to reach. It has a configuration file, that any user can create and costumize for their special purpus. If the default configuration is used, the program will change the .plan file, where any special info on your user will be fetched from, when someone tryes to finger you on the system. .SH "OPTIONS" .IX Header "OPTIONS" These are the command-line options for sigit: .ie n .IP """\-a """ 5 .el .IP "\f(CW\-a \fR" 5 .IX Item "-a " Use when you have a signature, you want to add to the data file. This flag will take a file as the second argument parsed to the program. ie: \&\fBsigit \-a sigfile.txt\fR This will add the signatures mentioned in the \f(CW\*(C`sigfile.txt\*(C'\fR, if there are more than one signature in the file, then they need to be seperated with 2 @ signs. And the first line in the file must start with a @@ else the program cant decide if there's multiple signatures to be found. Look in \f(CW\*(C`sigit.orig\*(C'\fR for the correct structure, when having multiple signatures. .ie n .IP """\-c """ 5 .el .IP "\f(CW\-c \fR" 5 .IX Item "-c " The will be usefull if you decide to run the program as a normal cronjob. This will make sure, the program only creates one signature befor exiting. .ie n .IP """\-e """ 5 .el .IP "\f(CW\-e \fR" 5 .IX Item "-e " This flag will read all the signatures found in the data file, and load your favorit editor as set in your \f(CW$EDITOR\fR with them. Here you can edit all the signatures as you prefere. Upon exit the program will rebuild the data file from the edited signatures. .ie n .IP """\-d """ 5 .el .IP "\f(CW\-d \fR" 5 .IX Item "-d " In order to run the program as a background you will have to suply it with the \f(CW\*(C`\-d\*(C'\fR. this change is made, since I found that the most frequent usage might either be as a cron job, or runnign as a normal process, since you would like it to get killed, once you logout. \fBHint\fR: \f(CW\*(C`you dont need to change the signatures for your emails, when your not loged in on the system, since very few people sends emails from their accounts while their not loged in.\*(C'\fR .ie n .IP """\-l """ 5 .el .IP "\f(CW\-l \fR" 5 .IX Item "-l " If you want all the signatures into a regular text file, then you need to use this flag, it will run the progra, as if it was the '\-e' flag you were using, but instead of loading your \f(CW$EDITOR\fR, it will save the files in the \fBfile\fR parset with the flag. .ie n .IP """\-r """ 5 .el .IP "\f(CW\-r \fR" 5 .IX Item "-r " Lets say you 'by accident' smashed the data file, then it is nice to know you can it. That is exactly what the \f(CW\*(C`\-r\*(C'\fR flag does, it will read from the file parsed to the program, and delete the previus data file, and replace it with one containing the signatures found in the file. .ie n .IP """\-u """ 5 .el .IP "\f(CW\-u \fR" 5 .IX Item "-u " If you look through your file, containing all teh signatures, and find that one specific dosn't need to be there any more, then use this flag, to remove the signature from the data file. ie: \&\fBsigit \-u 3AA9B568\fR .ie n .IP """\-v """ 5 .el .IP "\f(CW\-v \fR" 5 .IX Item "-v " Sometimes it's good to know how the program is running, and how far it's in the execution. Here comes as a very good solution. It will keep all the very specific infos hidden, yet let you know just what part of the program is beeing used, and how it went. .ie n .IP """\-vv """ 5 .el .IP "\f(CW\-vv \fR" 5 .IX Item "-vv " The usage of , is mostly usefull, when your trying to debug the thing, and you have no idear what caused it to abort. Throw in a couple more v's and see what sort of extra info is displayed :) .ie n .IP """\-V """ 5 .el .IP "\f(CW\-V \fR" 5 .IX Item "-V " The \f(CW\*(C`\-V\*(C'\fR will print the current version of the program, and exit. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIsigit.rc\fR\|(1) .SH "License and Disclaimer" .IX Header "License and Disclaimer" Sigit are Copyright (c) 2000 by Kenneth 'Redhead' Nielsen. Sigit may be used and distributed under the terms of the \s-1GNU\s0 General Public License. All other brand and product names are trademarks, registered trademarks or service marks of their respective holders. .PP These programs are distributed in the hope that it will be useful, but \&\s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the \s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this distribution; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, \s-1MA\s0 02111, \s-1USA\s0. .SH "Acknowledgments" .IX Header "Acknowledgments" Thanks go to: .IP "\(bu" 5 Rasmus 'moffe' Hansen, for beeing a good consultant through the whole process. .SH "CHANGES" .IX Header "CHANGES" See the \s-1README\s0 file that came with the source code. .SH "AUTHOR" .IX Header "AUTHOR" Sigit written by .PP Kenneth 'Redhead' Nielsen \f(CW\*(C`redhead@diku.dk\*(C'\fR .PP Documentation formatting by .PP Kenneth 'Redhead' Nielsen \f(CW\*(C`redhead@diku.dk\*(C'\fR .PP All future infos on the sigit exploration, can be found at: \f(CW\*(C`http://www.redhead.dk\*(C'\fR .SH "REPORTING BUG" .IX Header "REPORTING BUG" You can report any bugs from: \fBhttp://www.redhead.dk/download/bugs.html\fR