Logs

Logging

Directory

All logs generated by DC++ will be put in this subdirectory.
Default: the Logs\ subdirectory of where you've installed the application.

Log Main Chat

Enables the logging of the Main Chat logging in the hub window to a file: <address>.log. If there are illegal characters in the filename, such as colons, they will be replaced with underscores.

Main Chat Log Format

%[message] - Main chat message
Default format: [%Y-%m-%d %H:%M] %[message]

Log Private Chat

Enables the logging of Private Messages to a file named after the remote user.

Private Chat Log Format

%[message] - Private chat message
Default format: [%Y-%m-%d %H:%M] %[message]

Log Downloads

Enables the logging of completed downloads to Downloads.log. File list transfers may not be logged if you've disabled them under Advanced options.

Log Uploads

Enables the logging of completed uploads to Uploads.log.  File list transfers may not be logged if you've disabled them under Advanced options. Uploaded Tiger Tree Hash Leaves, added in 0.402, will also be logged.

Download and Upload Log Format

%[user] - User name
%[userip] - User's IP address
%[hub] - Hub name
%[hubip] - Hub's IP address
%[size] - File Size
%[sizeshort] - File size, shortened and including units
%[chunksize] - Size uploaded this session
%[chunksizeshort] - Size uploaded this session, short and including units
%[actualsize] - Actual uploaded bytes, affected by compression
%[actualsizeshort] - Actual uploaded bytes, short and including units
%[speed] - Speed of the transfer
%[time] - Elapsed time of the transfer
%[sfv] - Whether the file was checked against a SFV file (0 = no, 1 = yes).
%[tth] - Base32 representation of the tiger tree root hash
Only for Download log: %[target] - Local path and filename
Only for Upload log: %[source] - Local path for the upload.
Default download log format: %Y-%m-%d %H:%M: %[target] downloaded from %[user], %[size] (%[chunksize]), %[speed], %[time]
Default upload log format: %Y-%m-%d %H:%M: %[source] uploaded to %[user], %[size] (%[chunksize]), %[speed], %[time]

Log System Messages

Enables the logging of system-level messages. Examples of such messages are: notifications of files that have finished hashing, share refreshes, discovery of duplicate files, and disconnections of users who leave the hub (if enabled).

Log Status Messages

Enables the logging of status messages. Examples of such messages are: Connected to (and disconnected from ) hub, kicked, and banned messages. In short all messages that would appear below the chat input in the hub windows.

General Time Format Variables

The following time variables can be used in any of the log formats.

%a - Abbreviated weekday name
%A - Full weekday name
%b - Abbreviated month name
%B - Full month name
%c - Date and time representation appropriate for locale
%d - Day of month as decimal number (01 - 31)
%H - Hour in 24-hour format (00 - 23)
%I - Hour in 12-hour format (01 - 12)
%j - Day of year as decimal number (001 - 366)
%m - Month as decimal number (01 - 12)
%M - Minute as decimal number (00 - 59)
%p - Current locale's A.M./P.M. indicator for 12-hour clock
%S - Second as decimal number (00 - 59)
%U - Week of year as decimal number, with Sunday as first day of week (00 - 53)
%w - Weekday as decimal number (0 - 6; Sunday is 0)
%W - Week of year as decimal number, with Monday as first day of week (00 - 53)
%x - Date representation for current locale
%X - Time representation for current locale
%y - Year without century, as decimal number (00 - 99)
%Y - Year with century, as decimal number
%z, %Z - Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown

File Name Format

This enables you to name and rotate your logs. The following parameters can be used for Main / Private chat:
%[hub] - Name of hub (not known untill connected)
%[hubaddr] - Address (and port if non standard) of hub
%[user] - Users nick (only Private chat)
%[cid] - Users CID (only Private chat)
%[mycid] - Your own CID (only Private chat)
%[mynick] - Your own nick

These can be used for all files:
All general time format variables

Ex: Main chat: %[hubaddr]\%Y-%m.log - would result in this: example.no-ip.org\2004-12.log (if you are in the hub example.no-ip.org and it's december 2004)
Default: Main chat - %[hubaddr].log, Private message - %[user].log, Download - Downloads.log and Upload - Uploads.log