
 File Test Library 1.0
 by Ken "Jigen" Hollis

 This program is fully public domain, and may be given away freely as long as
 no modifications are made to its contents.

 If you have any suggestions, please mail them to khollis@chatlink.com

 More libraries like these (and hopefully more complex) are being worked on.
 This was just released because I have been using it for a while and it seems to
 be working great for me.

           >> To install the library, simply type "doinst" as superuser <<

 ------------------------------------------------------------------------------------

 Here are the routines that are available to make testing for files easier.  Make
 sure that when you call the routines, you include the file in parenthesis, or it
 will not work!  :-)

 is_read		- Test if a file is readable
 is_write		- Test if a file is writable
 is_exec		- Test if a file is executable
 is_user_own		- Test if a file is user-owned
 is_real_read		- Test if a file is real-user readable
 is_real_write		- Test if a file is real-user writable
 is_real_exec		- Test if a file is real-user executable
 is_exist		- Test if a file exists (should be used first!)
 is_exist_zero		- Test if a file exists and is a zero-length file
 is_exist_nonzero	- Test if a file exists and is a non-zero length file
 is_plain		- Test if a file is a plain file
 is_directory		- Test if a file is a directory
 is_link		- Test if a file is a symbolic link
 is_socket		- Test if a file is a socket file
 is_pipe		- Test if a file is a named pipe
 is_block_special	- Test if a file is a special block file
 is_char_special	- Test if a file is a special char file
 is_setuid		- Test if a file has SETUID enabled
 is_setgid		- Test if a file has SETGID enabled
 is_sticky_bit		- Test if a file has a sticky-bit set
 is_isatty		- Test if a file has isatty set
 is_text		- Test if a file is a text file
 is_binary		- Test if a file is a binary file
 is_modification_age	- Test if a file has a modification age in days bit set
 is_access_age		- Test if a file has an access age in days bit set
 is_inode_modification	- Test if a file has INODE Modification set

 Call these functions as you normally would any other file.  This is REALLY helpful
 when you are testing for files, and you want the code to be readable.  You don't
 have to use it, it is here as a convenience.

 -----------------------------------------------------------------------------------

 There is an example file that can be used for examples.  I have created a directory
 called "examples" that has some example files.  Try them out and you can see which
 files do what.

 The sample file is file-test.

 -----------------------------------------------------------------------------------

 If you have any suggestions or comments on what I could write, or what could be
 added to this library, please let me know.  I am willing to do just about anything
 in Perl.  :-)

                   d8P  d8P d8P d8P .a888b  d8P     d8P     d8P .d888b    
                  d8P.d8P  d8P d8P d8P"d8P d8P     d8P     d8P d8P" VP    
                 d888d.   d88888P d8P d8P d8P     d8P     d8P  V888b      
                d8P"d8P  d8P d8P d8P.a8P d8P     d8P     d8P dP .d8P      
               d8P  d8P d8P d8P  V888P" d88888P d88888P d8P  V888P"       

       [[ Ken Hollis -- Grants Pass Internet/Chatlink System Administrator ]]
               ((( khollis@chatlink.com <http://www.chatlink.com> )))

