Difference between revisions of "Usage File Details"

From AMule Project FAQ
Jump to: navigation, search
 
(10 intermediate revisions by 3 users not shown)
Line 14: Line 14:
  
 
The fields in the '''General''' box window are pretty intuitive:
 
The fields in the '''General''' box window are pretty intuitive:
−
*'''Full Name''': The name it will be given when it is completed
+
*'''Full Name''': The name it will be given when it is completed (or it's name if it is completed already)
−
*'''met-File''': Path where the file's [[part.met file]] is located
+
*'''met-File''': Path where the file's [[part.met file]] is located (or the same as '''Full name''' if completed)
 
*'''Hash''': The file's [[hash]]
 
*'''Hash''': The file's [[hash]]
−
*'''Filesize''': The file's total size once it is completed
+
*'''Filesize''': The file's total size once it is completed (or its current size if completed)
 
*'''Partfilestatus''': The file's status. I'ts values are described later
 
*'''Partfilestatus''': The file's status. I'ts values are described later
 
*'''Last seen complete''': Last time a source with the complete file was seen
 
*'''Last seen complete''': Last time a source with the complete file was seen
Line 28: Line 28:
 
| '''''Status''''' || '''Description'''
 
| '''''Status''''' || '''Description'''
 
|-
 
|-
−
| !!!!!! FILL THIS || !!! FILL ME!!
+
| ''Complete'' || The file has been successfully completed
 +
|-
 +
| ''Completing'' || The file has been aparently completed and is beign hashed to verify it this file
 +
|-
 +
| ''Downloading'' || The file is being currently downloaded to you
 +
|-
 +
| ''Waiting'' || The file is waiting for some client to uploaded to you
 +
|-
 +
| ''Paused'' || The file is paused
 +
|-
 +
| ''Stopped'' || The file is stopped
 +
|-
 +
| ''Insufficient Diskspace'' || There is not enough free disk space to download
 +
|-
 +
| ''Erroneous'' || Some error has ocurred when reading or creating this file
 
|}
 
|}
  
 
==== Transfer ====
 
==== Transfer ====
  
−
The '''Tranfser''' box shows statistics and details about the file's downloading overall process:
+
The '''Tranfser''' box shows statistics and details about the file's downloading overall process (note that when the file is completed, values may be turned to ''0''):
 
*'''Found Sources''': Amount of sources currently known for the file
 
*'''Found Sources''': Amount of sources currently known for the file
 
*'''Transferring Sources''': Amount of sources currently uploading the file to you
 
*'''Transferring Sources''': Amount of sources currently uploading the file to you
−
*'''Filepart-Count''': Amount of [[chunk]]s the file is devided into
+
*'''Filepart-Count''': Amount of [[FAQ_eD2k-Kademlia#What_is_a_chunk?|chunk]]s the file is devided into and, in brackets, the amount of chunk hashes known
−
*'''Available''': Amount of chunks of the file known to be available and the percentage this amount represents out of the total amount of chukns the file is composed of (in brackets)
+
*'''Available''': Amount of chunks of the file known to be available and the percentage this amount represents out of the total amount of chunks the file is composed of (in brackets)
−
*'''Datarate''': Speed in which the file is currently being uploaded to you. This field is more verbose than the speed reported in the [[[Usage_Transfer|Transfer]] window, since it displays up to two decimals
+
*'''Datarate''': Speed in which the file is currently being uploaded to you. This field is more verbose than the speed reported in the [[Usage_Transfer|Transfer]] window, since it displays up to two decimals
 
*'''Transferred''': Amount of data you have recieved for this file. This includes corrupted data if any was ever recieved
 
*'''Transferred''': Amount of data you have recieved for this file. This includes corrupted data if any was ever recieved
−
*'''Completed''': Amount of data you have comnpleted of the file ('''NOTE:''' This includes all data which hasn't yet been verified to be valid). The overall percentage this amount of data is to the file's total size is shown in brackets (again, this percentage is more accurate than the one that can be displayed in the Transfers window)
+
*'''Completed''': Amount of data you have completed of the file ('''NOTE:''' This includes all data which hasn't yet been verified to be valid). The overall percentage this amount of data is to the file's total size is shown in brackets (again, this percentage is more accurate than the one that can be displayed in the Transfers window)
  
 
http://www.amule.org/dev-up/window_file3.jpg
 
http://www.amule.org/dev-up/window_file3.jpg
Line 48: Line 62:
 
This box displays the statistics about the corruption handling:
 
This box displays the statistics about the corruption handling:
 
*'''Lost to corruption''': Amount of downloaded data which has been dropped because it has been known to be corrupted
 
*'''Lost to corruption''': Amount of downloaded data which has been dropped because it has been known to be corrupted
−
 
+
*'''Packages saved by I.C.H.''': Amount of [[packet]]s saved from corrupt chunks thanks to the [[ICH]] function
−
!!! MAKE SURE THIS IS CORRECT
+
−
*'''Packages saved by I.C.H.''': Amount of data saved from corrupt chunks thanks to the [[ICH]] function
+
 
*'''Gained by compression''': Amount of data which could be saved from downloading because of the protocol's compression capacities (Completed size - Transferred size)
 
*'''Gained by compression''': Amount of data which could be saved from downloading because of the protocol's compression capacities (Completed size - Transferred size)
  
Line 64: Line 76:
  
 
Not that not all sources report the filename they have given to the file.
 
Not that not all sources report the filename they have given to the file.
 +
 +
Also note that this list is cleared when the file is completed.
  
 
=== Rename ===
 
=== Rename ===
  
−
From this window you can rename the file's name when it will be completed. Just enter the filename yuo wish it to have in the text box and click the '''Rename''' button.
+
From this window you can rename the file's name when it will be completed. Just enter the filename you wish it to have in the text box and click the '''Rename''' button.
  
 
http://www.amule.org/dev-up/window_file6.jpg
 
http://www.amule.org/dev-up/window_file6.jpg
Line 79: Line 93:
 
http://www.amule.org/dev-up/window_file8.jpg
 
http://www.amule.org/dev-up/window_file8.jpg
  
−
This is what the cleanup function exactly does:
+
This is what the cleanup function exactly does (in this exact order):
−
*!!! FILL ME!
+
*The extension is made lowecase and never touched again (the dot before the extension is also kept all along the cleanup process)
 +
*Dots ("''.''"), low dashes ("''_''") and HTML space codes ("''%20''") are removed and replaced with single blank spaces ("'' ''")
 +
*Any ''hYPNOTiC'' appearance in the file name is removed
 +
*The filename is made lowercase
 +
*The following strings are removed (notice that all, except the first one, will have been turned lowercase and the dots, low dashes, etc replacement performed):
 +
**''www pornreactor com''
 +
**''sharereactor''
 +
**''found via www filedonkey com''
 +
**''deviance''
 +
**''adunanza''
 +
**''-ftv''
 +
**''flt''
 +
**''[]''
 +
**''()''
 +
*Notice ''xdmnx'', ''pmp'' and ''dws'' are not removed anymore
 +
*The following strings will be made uppercase (notice that the filename will have been turned lowercase):
 +
**''cd''
 +
**''vcd''
 +
**''dvd''
 +
**''iso''
 +
**''pc''
 +
*Make the first character of every word uppercase (if it is a lowercase letter)
 +
*Remove duplicate spaces (squeeze into just one single space character)
 +
*Remove dots ("''.''") after space characters
 +
*If the last character is a space ("'' ''"), it removes it
 +
*Replace ''By'' with ''by''
 +
 
 +
'''NOTE:''' Completed files cannot be renamed from here. They muts be renamed from the [[Usage_Shared_Files|Shared Files]] window.
  
 
=== Other ===
 
=== Other ===
Line 88: Line 129:
 
http://www.amule.org/dev-up/window_file9.jpg
 
http://www.amule.org/dev-up/window_file9.jpg
  
−
This may be very handy for those users who have no access to the file's context emnu in the Transfers window (mainly some Mac users), since the File Details window is easily accessible from the Transfers windows through [[Shortcut]]s.
+
This may be very handy for those users who have no access to the file's context menu in the Transfers window (mainly some Mac users), since the File Details window is easily accessible from the Transfers windows through [[Shortcut]]s.
  
 
To close the window, just click the '''Close''' button. It wil not apply changes which have not been applied yet.
 
To close the window, just click the '''Close''' button. It wil not apply changes which have not been applied yet.
Line 112: Line 153:
 
| 5 || ''Currently known sources for the file''
 
| 5 || ''Currently known sources for the file''
 
|-
 
|-
−
| 6 || ''Amount of chunks the file is composed of''
+
| 6 || ''Amount of chunks the file is composed of and, in brackets, the amount of part hashes known''
 
|-
 
|-
 
| 7 || ''Current download speed of the file''
 
| 7 || ''Current download speed of the file''
Line 120: Line 161:
 
| 9 || ''Amount of data lost because of corruption''
 
| 9 || ''Amount of data lost because of corruption''
 
|-
 
|-
−
| 10 || !!FIX ME ''Amount of corrrupted data saved from redownloading because of ICH''
+
| 10 || ''Amount of corrupted [[packet]]s saved from redownloading because of ICH''
 
|-
 
|-
 
| 11 || ''Take over the file's filename with the selected filename''
 
| 11 || ''Take over the file's filename with the selected filename''

Latest revision as of 03:53, 20 May 2006

Back to Index

Description

Through this windows you can see the selected file's details and you will be able to manage some of its settings.

http://www.amule.org/dev-up/window_file1.jpg

Usage

View details

General

The fields in the General box window are pretty intuitive:

  • Full Name: The name it will be given when it is completed (or it's name if it is completed already)
  • met-File: Path where the file's part.met file is located (or the same as Full name if completed)
  • Hash: The file's hash
  • Filesize: The file's total size once it is completed (or its current size if completed)
  • Partfilestatus: The file's status. I'ts values are described later
  • Last seen complete: Last time a source with the complete file was seen

http://www.amule.org/dev-up/window_file2.jpg

The possible value for the Partfilestatus field and their meanings are:

Status Description
Complete The file has been successfully completed
Completing The file has been aparently completed and is beign hashed to verify it this file
Downloading The file is being currently downloaded to you
Waiting The file is waiting for some client to uploaded to you
Paused The file is paused
Stopped The file is stopped
Insufficient Diskspace There is not enough free disk space to download
Erroneous Some error has ocurred when reading or creating this file

Transfer

The Tranfser box shows statistics and details about the file's downloading overall process (note that when the file is completed, values may be turned to 0):

  • Found Sources: Amount of sources currently known for the file
  • Transferring Sources: Amount of sources currently uploading the file to you
  • Filepart-Count: Amount of chunks the file is devided into and, in brackets, the amount of chunk hashes known
  • Available: Amount of chunks of the file known to be available and the percentage this amount represents out of the total amount of chunks the file is composed of (in brackets)
  • Datarate: Speed in which the file is currently being uploaded to you. This field is more verbose than the speed reported in the Transfer window, since it displays up to two decimals
  • Transferred: Amount of data you have recieved for this file. This includes corrupted data if any was ever recieved
  • Completed: Amount of data you have completed of the file (NOTE: This includes all data which hasn't yet been verified to be valid). The overall percentage this amount of data is to the file's total size is shown in brackets (again, this percentage is more accurate than the one that can be displayed in the Transfers window)

http://www.amule.org/dev-up/window_file3.jpg

Intelligent Corruption Handling

This box displays the statistics about the corruption handling:

  • Lost to corruption: Amount of downloaded data which has been dropped because it has been known to be corrupted
  • Packages saved by I.C.H.: Amount of packets saved from corrupt chunks thanks to the ICH function
  • Gained by compression: Amount of data which could be saved from downloading because of the protocol's compression capacities (Completed size - Transferred size)

http://www.amule.org/dev-up/window_file4.jpg

File names

This is a list of known names other clients have given this file. The File Name column displays the file it has been given and the Source column displays how much sources have reported to have given it that file name.

http://www.amule.org/dev-up/window_file5.jpg

This is a good place to see if a file is a fake.

Not that not all sources report the filename they have given to the file.

Also note that this list is cleared when the file is completed.

Rename

From this window you can rename the file's name when it will be completed. Just enter the filename you wish it to have in the text box and click the Rename button.

http://www.amule.org/dev-up/window_file6.jpg

You can easily change it with any of the filenames listed in the File Names list by clicking the filename you wish to adpot and then the Takeover button. This will write the filename in the text box. Now, as usual, click the Rename button.

http://www.amule.org/dev-up/window_file7.jpg

If you wish to perform some cleanup to the filename i the text box, you can click the Cleanup button. Remember to click the Rename button to apply the filename change.

http://www.amule.org/dev-up/window_file8.jpg

This is what the cleanup function exactly does (in this exact order):

  • The extension is made lowecase and never touched again (the dot before the extension is also kept all along the cleanup process)
  • Dots ("."), low dashes ("_") and HTML space codes ("%20") are removed and replaced with single blank spaces (" ")
  • Any hYPNOTiC appearance in the file name is removed
  • The filename is made lowercase
  • The following strings are removed (notice that all, except the first one, will have been turned lowercase and the dots, low dashes, etc replacement performed):
    • www pornreactor com
    • sharereactor
    • found via www filedonkey com
    • deviance
    • adunanza
    • -ftv
    • flt
    • []
    • ()
  • Notice xdmnx, pmp and dws are not removed anymore
  • The following strings will be made uppercase (notice that the filename will have been turned lowercase):
    • cd
    • vcd
    • dvd
    • iso
    • pc
  • Make the first character of every word uppercase (if it is a lowercase letter)
  • Remove duplicate spaces (squeeze into just one single space character)
  • Remove dots (".") after space characters
  • If the last character is a space (" "), it removes it
  • Replace By with by

NOTE: Completed files cannot be renamed from here. They muts be renamed from the Shared Files window.

Other

This window also provides an easy way to access the Comments window. Just click the Show all comments button.

http://www.amule.org/dev-up/window_file9.jpg

This may be very handy for those users who have no access to the file's context menu in the Transfers window (mainly some Mac users), since the File Details window is easily accessible from the Transfers windows through Shortcuts.

To close the window, just click the Close button. It wil not apply changes which have not been applied yet.

http://www.amule.org/dev-up/window_file11.jpg

Overview

http://www.amule.org/dev-up/window_file10.jpg

File Details quick Reference
Number Description
1 File's name
2 File's part.met location
3 File's hash
4 File's total size
5 Currently known sources for the file
6 Amount of chunks the file is composed of and, in brackets, the amount of part hashes known
7 Current download speed of the file
8 Total amount of transferred data for the file
9 Amount of data lost because of corruption
10 Amount of corrupted packets saved from redownloading because of ICH
11 Take over the file's filename with the selected filename
12 Filename to give the file
13 Close the window. This does not apply changes not yet applied
14 File's status
15 Last time a complete source was seen for the file
16 Current amount of sources uploading the file to you
17 Known to be available chunks and the percentage this chunks make of the file
18 Amount of data of the file completed and, in brackets, percentage this amount makes of the file
19 Amout of data safed from being downloaded because of the protocol's compression capabilities
20 List of known filenames for the file
21 Clean up the fiename in the text box (see description above)
22 Rename the file's filename with the text in the text box
23 See available comments for the file
Back to Index
Retrieved from "http://wiki.amule.org/w/index.php?title=Usage_File_Details&oldid=11813"