argument is hashref can be the gopts() return, or a conf hashref

you can specify database connection by

   -a abs path to sqlite | DBABSPATH

or mysql..

   -U username | DBUSER
   -P password | DBPASSWORD
   -D database name | DBNAME
   -H host, ni* | DBHOST
   -E metadata table name, ni*

ni* not implemented


does not return hidden files or hidden dirs returns dirs and files

arg is abs path, optional arg is number limit to return returns array ref


argument is message places time into message

the abs path to log is to /var/log/$PROGRAMNAME.log $PROGRAMNAME is $0 modified

returns message as was logged

   debug( cli_log('started') );