|
efileman 7.1
last changed : 01/24/10
| Log Files |
access.log
application.log
| download.log |
The download.log has the following structure:
filename1[tab]count value[tab]time value
filename2[tab]count value[tab]time value
...
The values are separated by Tab, because it's one of the few values (cross system) which are not allowed in a file name.
A filename (without path) will be added to the list by the first counted download, with that the count value start with 1. To identify a file is used only the filename (case sensitive) without path, no CRC or MD5 check.
The time value is the complete date of the first download represented by the number of non-leap seconds since whatever time the system considers to be the epoch (that's 00:00:00, January 1, 1904 for MacOS, and 00:00:00 UTC, January 1, 1970 for most other systems).
| access.log |
efileman log file configuration looks similar to eg. Apache web server log file configuration, but only the following items are supported:
| %h | Remote IP-address |
| %a | Remote IP-address |
| %f | Filename or Path |
| %u | Remote user |
| %t | Date and time of the request |
| %r | Similar to first line of request (see below) |
| %>s | This would be the status code that a web server sends back to the client according to RFC2616 section 10. efileman 7.1 will print 0 in every case. |
| %b | Bytes sent, excluding HTTP headers. |
| %B | Bytes sent, excluding HTTP headers. In CLF format i.e. a '-' rather than a 0 when no bytes are sent. |
| %{Referer}i | The site that the client reports having been referred from |
| %{User-agent}i | The identifying information that the client browser reports about itself. |
The format string may also contain the special control characters "\n" for new-line and "\t" for tab. Any time values are based on server system time (independent from efileman time shift parameter) to save comparability to Apache log files.
Some of the items above are adapted to efileman or are only supported for compatibility reasons.
The "hyphen" in the output indicates that the requested piece of information is not available.
It's not necessary to escape some characters like quotes, as you can see in default log file format for efileman 7.1:
%h %u %t "%r" %b
The above configuration will write log entries in a format known as the Common Log Format (CLF). This standard format can be produced by many different web servers and read by many log analysis programs. The log file entries produced in CLF will look something like this:
127.0.0.1 Erik [09/Nov/2003:16:44:01 +0100] "POST login HTTP/1.1" 0
127.0.0.1 Erik [09/Nov/2003:16:44:01 +0100] "POST HTTP/1.1" 28
127.0.0.1 Erik [09/Nov/2003:16:44:01 +0100] "POST opendir d:/homeip/html HTTP/1.1" 21398
127.0.0.1 (%h | %a)
This is the IP address of the client (remote host) which made the request to the server. The IP address reported here is not necessarily the address of the machine at which the user is sitting. If a proxy server exists between the user and the server, this address will be the address of the proxy, rather than the originating machine.
Erik (%u)
This is the username of the person requesting the document as determined by efileman login data.
[09/Nov/2003:16:44:01 +0100] (%t)
The time that the server finished processing the request. The format is:
[day/month/year:hour:minute:second zone]
day = 2*digit
month = 3*letter
year = 4*digit
hour = 2*digit
minute = 2*digit
second = 2*digit
zone = (`+' | `-') 4*digit
"POST opendir d:/homeip/html HTTP/1.1" ("%r")
This is similar to the request line from the client. It's given in double quotes. It contains at first the method used by the client: POST. Second, the user has opened the directory d:/homeip/html logged as "opendir", and third, the client used the protocol HTTP/1.1.
21398 (%b)
The last entry indicates the size of the object returned to the client, not including the response headers. If no content was returned to the client, this value will be "-". To log "0" for no content, use %B instead.
| application.log |
efileman knows 4 global hashs which contains the data available for all script methods. These are:
| %GLOBAL | all configured global values from efileman_config.pm |
| %CRACC | all configured default user values from efileman_config.pm |
| %FORM | all received data independent from HTTP method used by calling client |
| %USER | all data of current user identified by login processing methods |
For special reasons is used the hash %USERDATA which contains configured data of all user. The script adds data to the hashs whenever it's necessary to handle information between the method calls, eg. script_name which will be added to %USER hash. Therefore will be wrote two records to application.log during one script invocation by default, one at start after reading the config files (efileman_config.pm and the respective language file), and one before printing the result to calling client. Below an example record written during processing user login:
..........:Fri Nov 14 13:01:44 2003:..........
called from Package : module::ef_main
File: c:/homeip/cgi-bin/mod_perl/efileman7.1/module/ef_main.pm
Line : 135
..........:GLOBAL:..........
enable_mail = '1'
protectlinks = '0'
language = 'english'
log_format = '%h %l %u %t "%r" %>s %B %{Referer}i %{User-agent}i'
enable_dl_cnt = '1'
mailtoall = '1'
image_url = 'http://localhost/images/efileman'
register_mailtext = 'Dear User,
your new account data :
Username : ##username##
Password : ##password##
Please change your password immediately.'
lock_efileman = '0'
system_email_address = 'test@test.com'
generate_pwd = '1'
enable_admin = '1'
sessiontime = '30'
image_path = 'c:/homeip/html/images/efileman'
VERSION = '7.1'
show_disabled_button = '0'
skin = 'default'
log_path = 'c:/homeip/cgi-bin/mod_perl/efileman7.1/logfile'
max_user = '5'
reduceHTML = '0'
enable_register = '1'
enable_login = '1'
enable_sendpwd = '1'
zip_available = '0'
automake_userpath = '1'
usrfile_path = 'c:/homeip/cgi-bin/mod_perl/efileman7.1/usrfiles'
register_mailsubject = 'Your new efileman account data'
debug_modus_on = '1'
send_register_mail = '1'
max_Form_field_length = '300'
log_user_action = '1'
system_mail_signature = '--------------------------------------------------
This Mail has been generated and sent by efileman.'
enable_upload = '1'
newpwd_mailtext = 'Dear User,
your new account password is : ##password##
Please change this password immediately.'
file_lock = '1'
script_url = 'http://localhost/mod_perl/efileman7.1/efileman.cgi'
time_shift = '0'
upload_fields = '8'
upload_path = ''
server_name = 'localhost'
enable_sessiontime = '0'
mail_type = '192.168.0.110'
newpwd_mailsubject = 'New efileman account data'
..........:USER:..........
path_seperator = '1'
curversion = '7.1.0.85'
script_path = 'c:/homeip/cgi-bin/mod_perl/efileman7.1'
post = '28'
script_name = 'efileman.cgi'
..........:FORM:..........
pwd = 'Text removed by applog method'
crypted = '1'
user = 'test'
..........:Fri Nov 14 13:01:44 2003:..........
called from Package : module::ef_subs
File: d:/homeip/cgi-bin/mod_perl/efileman7.1/module/ef_subs.pm
Line : 186
..........:GLOBAL:..........
Here follows the values after processing by the script (before printing)
therefore you may find more and sometimes changed values.
|
|
|