Article 13086 of alt.sources:
Path: nntpd.lkg.dec.com!crl.dec.com!crl.dec.com!bloom-beacon.mit.edu!apollo.hp.com!lf.hp.com!news.dtc.hp.com!col.hp.com!nntp.coast.net!news.kei.com!newsfeed.internetmci.com!in1.uu.net!munnari.OZ.AU!news.mel.connect.com.au!yarrina.connect.com.au!news.mira.net.au!news.interdomain.net.au!news.apana.org.au!suburbia.net!proff
From: proff@suburbia.net (Julian Assange)
Newsgroups: comp.infosystems.www.authoring.cgi,comp.infosystems.www.authoring.html,comp.infosystems.www.authoring.images,comp.infosystems.www.misc,comp.infosystems.www.servers.unix,alt.sources,comp.unix.admin,apana.general
Subject: HomeAlone 0.91beta (fast disk/homepage/thumbprint/hidleho + more) indexer and html table generator
Date: 24 Dec 1995 00:47:18 GMT
Organization: Australian Public Access Network Association
Lines: 386
Message-ID: <4bi7um$16n@hock.apana.org.au>
NNTP-Posting-Host: suburbia.apana.org.au
X-Newsreader: TIN [version 1.2 PL2]
Xref: nntpd.lkg.dec.com comp.infosystems.www.authoring.cgi:18196 comp.infosystems.www.authoring.html:40684 comp.infosystems.www.authoring.images:7991 comp.infosystems.www.misc:42598 comp.infosystems.www.servers.unix:9486 alt.sources:13086 comp.unix.admin:43335

This is HomeAlone 0.91 beta (first public release!)

You can always ftp the current version from:

	 ftp://suburbia.net/pub/proff/original/homealone.tgz

I'll let the man page do the talking. It's DEC 24 and time to
be elsewhere. Merry xmass!

HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


NAME
       homealone  -  fast  user/directory/www  page  analyser and
       indexer

SYNOPSIS
       homealone [-3AbBdDEiImnNrRuWx] [-a address]  [-c  caption]
       [-e  command]  [-f  pattern] [-F pattern] [-g pattern] [-G
       pattern] [-h path] [-H directory] [-j [cdefilmnoqrstuwxz]]
       [-l  days]  [-L days] [-M address] [-o file] [-p file] [-P
       file] [-s [cCdDeEfFiIlLmMnNoOqQrRsStTuUwWxXzZ]] [-t thumb-
       nail] [-T URL] [-v pattern] [-V pattern] [-w width]


DESCRIPTION
       homealone  creates  indexes  and statistics of users, home
       directories and world wide web (home) pages  in  an  effi-
       cient manner (no PERL please, we are Australian).

OPTIONS
       -3     Produce HTML3.0 tabular output.

       -A     If  -S  or  -D  are  active  then examine all files
              scanned for the most recent timestamp.

       -a address
              Defines hostname to map user pages  onto,  e.g  '-a
              www.mydomain.org'.

       -b     Calaculate  disk usage from block count rather than
              file size.

       -B     Produce regular output  and  then  HTML3.0  tabular
              output.

       -c caption
              Specify  caption  (c.f -3) or heading for each home
              page list. A '%s' occuring within caption  is  spe-
              cial  and  will  be  replaced with the current sort
              description (c.f -s).  Multiple parameters  may  be
              specified for sucessive sorts.

       -d     Obtain  modification times from home page directory
              time stamp rather than  from  the  home  page  time
              stamp.

       -D     Perform usage statistics of users' home directories
              (c.f -I).

       -e command
              Use command to match home-page ($in), e.g 'agrep -2
              syphilology $in'.

       -E     Place  version details at end of output rather than
              at the start.



                                                                1





HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


       -f pattern
              Include all users who's finger information  matches
              pattern.  Multiple parameters may be specified.

       -F pattern
              Exclude  all users who's finger information matches
              pattern.  Multiple parameters may be specified.

       -g pattern
              Include all home pages with this pattern  in  them.
              Multiple parameters may be specified.

       -G pattern
              Include  files matching pattern for directory usage
              statistics.  Multiple parameters maybe specified.

       -h homepage
              Specify   path   to   homepage,   e.g   '-h    pub-
              lic_html/index.html'.

       -H directory
              Collect  hidleho  statistics  from  record files in
              directory. e.g '-H /usr/hidleho'.

       -i     Ingnore case differences when using pattern matches
              (c.f -g, -v).

       -I     Include  users into output even if they do not have
              a home page.

       -j flags
              The string flags controls  which  join  fields  are
              displayed  and  in  what  order  they present them-
              selves. The field descriptions will also  be  auto-
              matically  calculated  and  aligned. The flags that
              can be used are are identical to  those  used  with
              the -s (sort) option. Please refer to it for detail
              on the fields associated with each flag.

       -l days
              Select only pages last modified  in  the  specified
              number of days.

       -L days
              Select pages modified after the specified number of
              days.

       -m     Attach a 'mailto:' url to the users login name.

       -M address
              Specify a mailing address different to that of  the
              home page address.

       -n     Do not output final analysis statistics.



                                                                2





HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


       -N     Do not scan for home pages.

       -o file
              Direct  output  to  file. Multiple parameters maybe
              specified, in which case sucessive sort  operations
              will  be  placed  into  sucessive  files,  with any
              remaining output being placed into the  last  file.
              If  the filename contains the string '%d' then that
              portion is replaced with an incremental count.

       -p file
              Use file instead of /etc/passwd to  obtain  account
              information.

       -P file
              Don't  scan  accounts,  but  use  the pre-generated
              (with -u)  file  instead  to  get  usernames,  time
              stamps  and  usage  statistics.  This is useful for
              interactive access. You  can  merely  generate  one
              fairly  complete -P compatible file of all accounts
              with usage statistics enabled once  every  day  (or
              so)  via  a cron and then perform frequent (perhaps
              CGI based) queries on that data (quite  efficient).

       -r     Reverse  the  pattern matching order so that inclu-
              sive patterns are  matched  before  exclusive  pat-
              terns.

       -R     Specifiy  that  the  www  deamon normally runs with
              root privs i.e can read protected  files/dirs.   If
              without this flag HomeAlone will perform permission
              checks on the homepage, the www  sub-directory  and
              the  user's home directory. Pages that fail will be
              excluded.

       -s [rRuUlLdDfFsS]
              Sort  output  according  to   specified   criteria.
              Reverse  order  sorting is indicated with uppercase
              sort flags. Several flags  may  be  specified,  the
              first  being dominant. e.g '-s Dl' sorts by reverse
              days since modification but if the dates are  iden-
              tical  then  duplicates  are  sorted alphabetically
              according to the login  name.  Multiple  parameters
              maybe given, causing multiple output (c.f -o). Sev-
              eral sorting types are available:

              c      sort by the number of hidleho  credits  used
                     (requires hidleho).

              d      sort   by   home  directory  age  (in  days)
                     (requires hidleho) (c.f -H, -D, -d, -A).

              e      sort by time left (requires hidleho).




                                                                3





HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


              f      sort by number of files in the  user's  home
                     directory (requires -D).

              i      sort by user id number.

              l      sort  by last login time (requires hidleho).

              m      sort by  home  directory  modification  time
                     (c.f -D, -d, -A).

              n      sort by number of logins (requires hidleho).

              o      sort by time on-line (requires hidleho).

              q      sort by number of www files.

              r      sort by the real name surname.

              s      sort by the total size of files (c.f -D).

              t      sort by presense of  a  thumbnail  (c.f  -t,
                     -T).

              u      sort  by  user  name.  w sort by home page /
                     www directory modification time (c.f -d, -A,
                     -N).

              x      sort  by  home  page / www directory age (in
                     days) (c.f -d, -A, -N).

              z      sort by total size of www files (c.f -W).

       -t thumbnail
              Look for the  file  thumbnail  in  the  user's  www
              directory  (c.f  -s  t).  Multiple parameters maybe
              specified. e.g '-t thumbnail.gif -t thumbnail.jpg'

       -T URL If a valid thumbnail can  not  be  found,  use  URL
              instead.            e.g           '-T          <IMG
              SRC=http://suburbia.net/img/default_thumbnail.gif
              ALT=Home>'.

       -u     User  implementation.  Output  fields  seperated by
              ':'. This makes it easy to automatically parse  the
              output  with  awk  -F:  (etc) or the -P option. The
              fields are: username, uid, full name, homepage sta-
              tus  (1=found,  0=not  found/bad),  home directory,
              days   since   update,   timestamp,   files   used,
              bytes/blocks used.

       -v pattern
              Exclude  all  home pages with this pattern in them.
              Multiple parameters may be specified.




                                                                4





HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


       -V pattern
              Exclude files matching pattern for directory  usage
              statistics.  Multiple parameters maybe specified.

       -w width
              Extra  white  space seperation width. Seperation is
              normally calculated based on  the  maximal  element
              length encountered during a run (providing the list
              is sorted).

       -W     Scan www directories for  disk/file  usage  statis-
              tics.

       -x     Use  regular expression pattern matching instead of
              substring matching for searching  home  pages  (c.f
              -g, -v).

EXAMPLE
       homealone -a "www.suburbia.net" -B -M "suburbia.net" -D -W
       -d -A -jurndsxw -su -snu -sFS -sSF -T  -o  first_page.html
       -o           rest_of_pages%d.html          -c          "<a
       href=http://suburbia.net/>Suburbia.Net</a>  homepages   by
       %s" -H /usr/hidleho

       Produces  index  pages  according  to  username, number of
       calls (requires hidleho) number of  files  used  and  disk
       usage  in  both  HTML1+  and  HTML3.0 tabular format, with
       username, reallname, number of calls, home  directory  age
       (newest  file  age  in  days),  home  directory usage, www
       directory age (newest file age in days) and www  directory
       usage as fields.

AUTHOR
       Julian Assange (proff@suburbia.net)

ARCHIVE
       The  latest  version  of this program can be obtained from
       the   Suburbia    archives    at    ftp.suburbia.net    or
       ftp://suburbia.net/pub/proff/original/homealone.tgz.

BUGS AND SUGGESTIONS
       homealone  when  used  with  the -o option will not behave
       predictably if a printf() format specifier other  than  %d
       is  imbedded  within  the  file  name.  This may change in
       future versions.

       Please send any license  requests,  bug  reports,  sugges-
       tions, words of encouragement or supercilious wit to home-
       alone@suburbia.net.

LICENSING
       This software may not be used by commercial or  government
       bodies without a site license. Please refer to the LICENS-
       ING file in the source distribution for details,  or  send



                                                                5





HOMEALONE 0.91(1)                               HOMEALONE 0.91(1)


       email to homealone@suburbia.net.

COPYRIGHT AND WARRANTY INFO
       Copyright (c) Julian Assange 1995, All rights reserved.

       This  software  maybe used freely by registered non-profit
       organizations and non-profit educational institutions. All
       other users and organizations, including government bodies
       and organizations shall be defined  for  the  purposes  of
       this document as commercial users.

       Commercial  users  may  not  use  this software without an
       appropriate agreement or license with the  Author.  Please
       see  the  documentation  on  LICENSING contained elsewhere
       with this software.

       This software maybe distributed only freely, in  full  and
       without modification.  It may not be bundled with any sort
       of hardware or software if a fee is charged for that hard-
       ware  or software directly or indirectly for that hardware
       or software.  If you would like to include  this  software
       in  such  a distribution then please contact the author to
       negotiate reasonable (possibly free) terms.

       The author shall not under any  circumstances  accept  any
       liability  for  this software, for its use, misuse, or any
       failings it may or may not have. Your on your own.

       The author reserves the right to alter  the  aformentioned
       conditions  from  time to time as he sees appropriate. The
       author's most recent copyright notice and  conditions  for
       this software always supersede any issued previously.

       Use  and  or  distribution of this software implies accep-
       tance of the above.

SEE ALSO
       hidleho(8), find(1), du(1), regex(3), ed(1), grep(1).

+----------------------------------+-----------------------------------------+
|Julian Assange                    | "if you think the United  States has    |
|FAX: +61-3-9819-9066              |  has stood still, who built the largest |
|EMAIL: proff@suburbia.net         |  shopping centre in the world?" - Nixon |
+----------------------------------+-----------------------------------------+


