From c605c8021f5dfd2b760172131a928c42be5133d1 Mon Sep 17 00:00:00 2001
From: Arvid Norberg <arvid@libtorrent.org>
Date: Sun, 20 Jul 2008 16:00:08 +0000
Subject: [PATCH] added file priority functions

---
 docs/manual.html                      | 260 ++++++++++++++------------
 docs/manual.rst                       |  31 ++-
 include/libtorrent/torrent.hpp        |   8 +
 include/libtorrent/torrent_handle.hpp |   6 +-
 src/storage.cpp                       |  16 +-
 src/torrent.cpp                       |  60 +++++-
 src/torrent_handle.cpp                |  20 ++
 7 files changed, 270 insertions(+), 131 deletions(-)

diff --git a/docs/manual.html b/docs/manual.html
index c08a031c4..312d337a9 100644
--- a/docs/manual.html
+++ b/docs/manual.html
@@ -83,145 +83,146 @@
 </ul>
 </li>
 <li><a class="reference" href="#torrent-handle" id="id70" name="id70">torrent_handle</a><ul>
-<li><a class="reference" href="#piece-priority-prioritize-pieces-piece-priorities-prioritize-files" id="id71" name="id71">piece_priority() prioritize_pieces() piece_priorities() prioritize_files()</a></li>
-<li><a class="reference" href="#file-progress" id="id72" name="id72">file_progress()</a></li>
-<li><a class="reference" href="#save-path" id="id73" name="id73">save_path()</a></li>
-<li><a class="reference" href="#move-storage" id="id74" name="id74">move_storage()</a></li>
-<li><a class="reference" href="#force-reannounce" id="id75" name="id75">force_reannounce()</a></li>
-<li><a class="reference" href="#scrape-tracker" id="id76" name="id76">scrape_tracker()</a></li>
-<li><a class="reference" href="#connect-peer" id="id77" name="id77">connect_peer()</a></li>
-<li><a class="reference" href="#name" id="id78" name="id78">name()</a></li>
-<li><a class="reference" href="#set-ratio" id="id79" name="id79">set_ratio()</a></li>
-<li><a class="reference" href="#set-upload-limit-set-download-limit-upload-limit-download-limit" id="id80" name="id80">set_upload_limit() set_download_limit() upload_limit() download_limit()</a></li>
-<li><a class="reference" href="#set-sequential-download-is-sequential-download" id="id81" name="id81">set_sequential_download() is_sequential_download()</a></li>
-<li><a class="reference" href="#set-peer-upload-limit-set-peer-download-limit" id="id82" name="id82">set_peer_upload_limit() set_peer_download_limit()</a></li>
-<li><a class="reference" href="#id5" id="id83" name="id83">pause() resume() is_paused()</a></li>
-<li><a class="reference" href="#force-recheck" id="id84" name="id84">force_recheck()</a></li>
-<li><a class="reference" href="#clear-error" id="id85" name="id85">clear_error()</a></li>
-<li><a class="reference" href="#resolve-countries" id="id86" name="id86">resolve_countries()</a></li>
-<li><a class="reference" href="#is-seed" id="id87" name="id87">is_seed()</a></li>
-<li><a class="reference" href="#is-auto-managed-auto-managed" id="id88" name="id88">is_auto_managed() auto_managed()</a></li>
-<li><a class="reference" href="#has-metadata" id="id89" name="id89">has_metadata()</a></li>
-<li><a class="reference" href="#set-tracker-login" id="id90" name="id90">set_tracker_login()</a></li>
-<li><a class="reference" href="#trackers-replace-trackers" id="id91" name="id91">trackers() replace_trackers()</a></li>
-<li><a class="reference" href="#add-url-seed-remove-url-seed-url-seeds" id="id92" name="id92">add_url_seed() remove_url_seed() url_seeds()</a></li>
-<li><a class="reference" href="#queue-position-queue-position-up-queue-position-down-queue-position-top-queue-position-bottom" id="id93" name="id93">queue_position() queue_position_up() queue_position_down() queue_position_top() queue_position_bottom()</a></li>
-<li><a class="reference" href="#use-interface" id="id94" name="id94">use_interface()</a></li>
-<li><a class="reference" href="#info-hash" id="id95" name="id95">info_hash()</a></li>
-<li><a class="reference" href="#id6" id="id96" name="id96">set_max_uploads() set_max_connections()</a></li>
-<li><a class="reference" href="#save-resume-data" id="id97" name="id97">save_resume_data()</a></li>
-<li><a class="reference" href="#id7" id="id98" name="id98">status()</a></li>
-<li><a class="reference" href="#get-download-queue" id="id99" name="id99">get_download_queue()</a></li>
-<li><a class="reference" href="#get-peer-info" id="id100" name="id100">get_peer_info()</a></li>
-<li><a class="reference" href="#get-torrent-info" id="id101" name="id101">get_torrent_info()</a></li>
-<li><a class="reference" href="#is-valid" id="id102" name="id102">is_valid()</a></li>
+<li><a class="reference" href="#piece-priority-prioritize-pieces-piece-priorities" id="id71" name="id71">piece_priority() prioritize_pieces() piece_priorities()</a></li>
+<li><a class="reference" href="#file-priority-prioritize-files-file-priorities" id="id72" name="id72">file_priority() prioritize_files() file_priorities()</a></li>
+<li><a class="reference" href="#file-progress" id="id73" name="id73">file_progress()</a></li>
+<li><a class="reference" href="#save-path" id="id74" name="id74">save_path()</a></li>
+<li><a class="reference" href="#move-storage" id="id75" name="id75">move_storage()</a></li>
+<li><a class="reference" href="#force-reannounce" id="id76" name="id76">force_reannounce()</a></li>
+<li><a class="reference" href="#scrape-tracker" id="id77" name="id77">scrape_tracker()</a></li>
+<li><a class="reference" href="#connect-peer" id="id78" name="id78">connect_peer()</a></li>
+<li><a class="reference" href="#name" id="id79" name="id79">name()</a></li>
+<li><a class="reference" href="#set-ratio" id="id80" name="id80">set_ratio()</a></li>
+<li><a class="reference" href="#set-upload-limit-set-download-limit-upload-limit-download-limit" id="id81" name="id81">set_upload_limit() set_download_limit() upload_limit() download_limit()</a></li>
+<li><a class="reference" href="#set-sequential-download-is-sequential-download" id="id82" name="id82">set_sequential_download() is_sequential_download()</a></li>
+<li><a class="reference" href="#set-peer-upload-limit-set-peer-download-limit" id="id83" name="id83">set_peer_upload_limit() set_peer_download_limit()</a></li>
+<li><a class="reference" href="#id5" id="id84" name="id84">pause() resume() is_paused()</a></li>
+<li><a class="reference" href="#force-recheck" id="id85" name="id85">force_recheck()</a></li>
+<li><a class="reference" href="#clear-error" id="id86" name="id86">clear_error()</a></li>
+<li><a class="reference" href="#resolve-countries" id="id87" name="id87">resolve_countries()</a></li>
+<li><a class="reference" href="#is-seed" id="id88" name="id88">is_seed()</a></li>
+<li><a class="reference" href="#is-auto-managed-auto-managed" id="id89" name="id89">is_auto_managed() auto_managed()</a></li>
+<li><a class="reference" href="#has-metadata" id="id90" name="id90">has_metadata()</a></li>
+<li><a class="reference" href="#set-tracker-login" id="id91" name="id91">set_tracker_login()</a></li>
+<li><a class="reference" href="#trackers-replace-trackers" id="id92" name="id92">trackers() replace_trackers()</a></li>
+<li><a class="reference" href="#add-url-seed-remove-url-seed-url-seeds" id="id93" name="id93">add_url_seed() remove_url_seed() url_seeds()</a></li>
+<li><a class="reference" href="#queue-position-queue-position-up-queue-position-down-queue-position-top-queue-position-bottom" id="id94" name="id94">queue_position() queue_position_up() queue_position_down() queue_position_top() queue_position_bottom()</a></li>
+<li><a class="reference" href="#use-interface" id="id95" name="id95">use_interface()</a></li>
+<li><a class="reference" href="#info-hash" id="id96" name="id96">info_hash()</a></li>
+<li><a class="reference" href="#id6" id="id97" name="id97">set_max_uploads() set_max_connections()</a></li>
+<li><a class="reference" href="#save-resume-data" id="id98" name="id98">save_resume_data()</a></li>
+<li><a class="reference" href="#id7" id="id99" name="id99">status()</a></li>
+<li><a class="reference" href="#get-download-queue" id="id100" name="id100">get_download_queue()</a></li>
+<li><a class="reference" href="#get-peer-info" id="id101" name="id101">get_peer_info()</a></li>
+<li><a class="reference" href="#get-torrent-info" id="id102" name="id102">get_torrent_info()</a></li>
+<li><a class="reference" href="#is-valid" id="id103" name="id103">is_valid()</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#torrent-status" id="id103" name="id103">torrent_status</a></li>
-<li><a class="reference" href="#peer-info" id="id104" name="id104">peer_info</a></li>
-<li><a class="reference" href="#session-settings" id="id105" name="id105">session_settings</a></li>
-<li><a class="reference" href="#pe-settings" id="id106" name="id106">pe_settings</a></li>
-<li><a class="reference" href="#proxy-settings" id="id107" name="id107">proxy_settings</a></li>
-<li><a class="reference" href="#ip-filter" id="id108" name="id108">ip_filter</a><ul>
-<li><a class="reference" href="#id10" id="id109" name="id109">ip_filter()</a></li>
-<li><a class="reference" href="#add-rule" id="id110" name="id110">add_rule()</a></li>
-<li><a class="reference" href="#access" id="id111" name="id111">access()</a></li>
-<li><a class="reference" href="#export-filter" id="id112" name="id112">export_filter()</a></li>
+<li><a class="reference" href="#torrent-status" id="id104" name="id104">torrent_status</a></li>
+<li><a class="reference" href="#peer-info" id="id105" name="id105">peer_info</a></li>
+<li><a class="reference" href="#session-settings" id="id106" name="id106">session_settings</a></li>
+<li><a class="reference" href="#pe-settings" id="id107" name="id107">pe_settings</a></li>
+<li><a class="reference" href="#proxy-settings" id="id108" name="id108">proxy_settings</a></li>
+<li><a class="reference" href="#ip-filter" id="id109" name="id109">ip_filter</a><ul>
+<li><a class="reference" href="#id10" id="id110" name="id110">ip_filter()</a></li>
+<li><a class="reference" href="#add-rule" id="id111" name="id111">add_rule()</a></li>
+<li><a class="reference" href="#access" id="id112" name="id112">access()</a></li>
+<li><a class="reference" href="#export-filter" id="id113" name="id113">export_filter()</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#big-number" id="id113" name="id113">big_number</a></li>
-<li><a class="reference" href="#bitfield" id="id114" name="id114">bitfield</a></li>
-<li><a class="reference" href="#hasher" id="id115" name="id115">hasher</a></li>
-<li><a class="reference" href="#fingerprint" id="id116" name="id116">fingerprint</a></li>
-<li><a class="reference" href="#upnp-and-nat-pmp" id="id117" name="id117">UPnP and NAT-PMP</a><ul>
-<li><a class="reference" href="#add-mapping" id="id118" name="id118">add_mapping</a></li>
-<li><a class="reference" href="#delete-mapping" id="id119" name="id119">delete_mapping</a></li>
-<li><a class="reference" href="#router-model" id="id120" name="id120">router_model()</a></li>
+<li><a class="reference" href="#big-number" id="id114" name="id114">big_number</a></li>
+<li><a class="reference" href="#bitfield" id="id115" name="id115">bitfield</a></li>
+<li><a class="reference" href="#hasher" id="id116" name="id116">hasher</a></li>
+<li><a class="reference" href="#fingerprint" id="id117" name="id117">fingerprint</a></li>
+<li><a class="reference" href="#upnp-and-nat-pmp" id="id118" name="id118">UPnP and NAT-PMP</a><ul>
+<li><a class="reference" href="#add-mapping" id="id119" name="id119">add_mapping</a></li>
+<li><a class="reference" href="#delete-mapping" id="id120" name="id120">delete_mapping</a></li>
+<li><a class="reference" href="#router-model" id="id121" name="id121">router_model()</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#free-functions" id="id121" name="id121">free functions</a><ul>
-<li><a class="reference" href="#identify-client" id="id122" name="id122">identify_client()</a></li>
-<li><a class="reference" href="#client-fingerprint" id="id123" name="id123">client_fingerprint()</a></li>
-<li><a class="reference" href="#bdecode-bencode" id="id124" name="id124">bdecode() bencode()</a></li>
+<li><a class="reference" href="#free-functions" id="id122" name="id122">free functions</a><ul>
+<li><a class="reference" href="#identify-client" id="id123" name="id123">identify_client()</a></li>
+<li><a class="reference" href="#client-fingerprint" id="id124" name="id124">client_fingerprint()</a></li>
+<li><a class="reference" href="#bdecode-bencode" id="id125" name="id125">bdecode() bencode()</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#alerts" id="id125" name="id125">alerts</a><ul>
-<li><a class="reference" href="#external-ip-alert" id="id126" name="id126">external_ip_alert</a></li>
-<li><a class="reference" href="#listen-failed-alert" id="id127" name="id127">listen_failed_alert</a></li>
-<li><a class="reference" href="#portmap-error-alert" id="id128" name="id128">portmap_error_alert</a></li>
-<li><a class="reference" href="#portmap-alert" id="id129" name="id129">portmap_alert</a></li>
-<li><a class="reference" href="#file-error-alert" id="id130" name="id130">file_error_alert</a></li>
-<li><a class="reference" href="#tracker-announce-alert" id="id131" name="id131">tracker_announce_alert</a></li>
-<li><a class="reference" href="#tracker-error-alert" id="id132" name="id132">tracker_error_alert</a></li>
-<li><a class="reference" href="#tracker-reply-alert" id="id133" name="id133">tracker_reply_alert</a></li>
-<li><a class="reference" href="#dht-reply-alert" id="id134" name="id134">dht_reply_alert</a></li>
-<li><a class="reference" href="#tracker-warning-alert" id="id135" name="id135">tracker_warning_alert</a></li>
-<li><a class="reference" href="#scrape-reply-alert" id="id136" name="id136">scrape_reply_alert</a></li>
-<li><a class="reference" href="#scrape-failed-alert" id="id137" name="id137">scrape_failed_alert</a></li>
-<li><a class="reference" href="#url-seed-alert" id="id138" name="id138">url_seed_alert</a></li>
-<li><a class="reference" href="#hash-failed-alert" id="id139" name="id139">hash_failed_alert</a></li>
-<li><a class="reference" href="#peer-ban-alert" id="id140" name="id140">peer_ban_alert</a></li>
-<li><a class="reference" href="#peer-error-alert" id="id141" name="id141">peer_error_alert</a></li>
-<li><a class="reference" href="#invalid-request-alert" id="id142" name="id142">invalid_request_alert</a></li>
-<li><a class="reference" href="#torrent-finished-alert" id="id143" name="id143">torrent_finished_alert</a></li>
-<li><a class="reference" href="#metadata-failed-alert" id="id144" name="id144">metadata_failed_alert</a></li>
-<li><a class="reference" href="#metadata-received-alert" id="id145" name="id145">metadata_received_alert</a></li>
-<li><a class="reference" href="#fastresume-rejected-alert" id="id146" name="id146">fastresume_rejected_alert</a></li>
-<li><a class="reference" href="#peer-blocked-alert" id="id147" name="id147">peer_blocked_alert</a></li>
-<li><a class="reference" href="#storage-moved-alert" id="id148" name="id148">storage_moved_alert</a></li>
-<li><a class="reference" href="#torrent-paused-alert" id="id149" name="id149">torrent_paused_alert</a></li>
-<li><a class="reference" href="#torrent-resumed-alert" id="id150" name="id150">torrent_resumed_alert</a></li>
-<li><a class="reference" href="#save-resume-data-alert" id="id151" name="id151">save_resume_data_alert</a></li>
-<li><a class="reference" href="#save-resume-data-failed-alert" id="id152" name="id152">save_resume_data_failed_alert</a></li>
-<li><a class="reference" href="#dispatcher" id="id153" name="id153">dispatcher</a></li>
+<li><a class="reference" href="#alerts" id="id126" name="id126">alerts</a><ul>
+<li><a class="reference" href="#external-ip-alert" id="id127" name="id127">external_ip_alert</a></li>
+<li><a class="reference" href="#listen-failed-alert" id="id128" name="id128">listen_failed_alert</a></li>
+<li><a class="reference" href="#portmap-error-alert" id="id129" name="id129">portmap_error_alert</a></li>
+<li><a class="reference" href="#portmap-alert" id="id130" name="id130">portmap_alert</a></li>
+<li><a class="reference" href="#file-error-alert" id="id131" name="id131">file_error_alert</a></li>
+<li><a class="reference" href="#tracker-announce-alert" id="id132" name="id132">tracker_announce_alert</a></li>
+<li><a class="reference" href="#tracker-error-alert" id="id133" name="id133">tracker_error_alert</a></li>
+<li><a class="reference" href="#tracker-reply-alert" id="id134" name="id134">tracker_reply_alert</a></li>
+<li><a class="reference" href="#dht-reply-alert" id="id135" name="id135">dht_reply_alert</a></li>
+<li><a class="reference" href="#tracker-warning-alert" id="id136" name="id136">tracker_warning_alert</a></li>
+<li><a class="reference" href="#scrape-reply-alert" id="id137" name="id137">scrape_reply_alert</a></li>
+<li><a class="reference" href="#scrape-failed-alert" id="id138" name="id138">scrape_failed_alert</a></li>
+<li><a class="reference" href="#url-seed-alert" id="id139" name="id139">url_seed_alert</a></li>
+<li><a class="reference" href="#hash-failed-alert" id="id140" name="id140">hash_failed_alert</a></li>
+<li><a class="reference" href="#peer-ban-alert" id="id141" name="id141">peer_ban_alert</a></li>
+<li><a class="reference" href="#peer-error-alert" id="id142" name="id142">peer_error_alert</a></li>
+<li><a class="reference" href="#invalid-request-alert" id="id143" name="id143">invalid_request_alert</a></li>
+<li><a class="reference" href="#torrent-finished-alert" id="id144" name="id144">torrent_finished_alert</a></li>
+<li><a class="reference" href="#metadata-failed-alert" id="id145" name="id145">metadata_failed_alert</a></li>
+<li><a class="reference" href="#metadata-received-alert" id="id146" name="id146">metadata_received_alert</a></li>
+<li><a class="reference" href="#fastresume-rejected-alert" id="id147" name="id147">fastresume_rejected_alert</a></li>
+<li><a class="reference" href="#peer-blocked-alert" id="id148" name="id148">peer_blocked_alert</a></li>
+<li><a class="reference" href="#storage-moved-alert" id="id149" name="id149">storage_moved_alert</a></li>
+<li><a class="reference" href="#torrent-paused-alert" id="id150" name="id150">torrent_paused_alert</a></li>
+<li><a class="reference" href="#torrent-resumed-alert" id="id151" name="id151">torrent_resumed_alert</a></li>
+<li><a class="reference" href="#save-resume-data-alert" id="id152" name="id152">save_resume_data_alert</a></li>
+<li><a class="reference" href="#save-resume-data-failed-alert" id="id153" name="id153">save_resume_data_failed_alert</a></li>
+<li><a class="reference" href="#dispatcher" id="id154" name="id154">dispatcher</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#exceptions" id="id154" name="id154">exceptions</a><ul>
-<li><a class="reference" href="#invalid-handle" id="id155" name="id155">invalid_handle</a></li>
-<li><a class="reference" href="#duplicate-torrent" id="id156" name="id156">duplicate_torrent</a></li>
-<li><a class="reference" href="#invalid-encoding" id="id157" name="id157">invalid_encoding</a></li>
-<li><a class="reference" href="#type-error" id="id158" name="id158">type_error</a></li>
-<li><a class="reference" href="#invalid-torrent-file" id="id159" name="id159">invalid_torrent_file</a></li>
+<li><a class="reference" href="#exceptions" id="id155" name="id155">exceptions</a><ul>
+<li><a class="reference" href="#invalid-handle" id="id156" name="id156">invalid_handle</a></li>
+<li><a class="reference" href="#duplicate-torrent" id="id157" name="id157">duplicate_torrent</a></li>
+<li><a class="reference" href="#invalid-encoding" id="id158" name="id158">invalid_encoding</a></li>
+<li><a class="reference" href="#type-error" id="id159" name="id159">type_error</a></li>
+<li><a class="reference" href="#invalid-torrent-file" id="id160" name="id160">invalid_torrent_file</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#storage-interface" id="id160" name="id160">storage_interface</a><ul>
-<li><a class="reference" href="#initialize" id="id161" name="id161">initialize()</a></li>
-<li><a class="reference" href="#read" id="id162" name="id162">read()</a></li>
-<li><a class="reference" href="#write" id="id163" name="id163">write()</a></li>
-<li><a class="reference" href="#id12" id="id164" name="id164">move_storage()</a></li>
-<li><a class="reference" href="#verify-resume-data" id="id165" name="id165">verify_resume_data()</a></li>
-<li><a class="reference" href="#write-resume-data" id="id166" name="id166">write_resume_data()</a></li>
-<li><a class="reference" href="#move-slot" id="id167" name="id167">move_slot()</a></li>
-<li><a class="reference" href="#swap-slots" id="id168" name="id168">swap_slots()</a></li>
-<li><a class="reference" href="#swap-slots3" id="id169" name="id169">swap_slots3()</a></li>
-<li><a class="reference" href="#hash-for-slot" id="id170" name="id170">hash_for_slot()</a></li>
-<li><a class="reference" href="#release-files" id="id171" name="id171">release_files()</a></li>
-<li><a class="reference" href="#delete-files" id="id172" name="id172">delete_files()</a></li>
+<li><a class="reference" href="#storage-interface" id="id161" name="id161">storage_interface</a><ul>
+<li><a class="reference" href="#initialize" id="id162" name="id162">initialize()</a></li>
+<li><a class="reference" href="#read" id="id163" name="id163">read()</a></li>
+<li><a class="reference" href="#write" id="id164" name="id164">write()</a></li>
+<li><a class="reference" href="#id12" id="id165" name="id165">move_storage()</a></li>
+<li><a class="reference" href="#verify-resume-data" id="id166" name="id166">verify_resume_data()</a></li>
+<li><a class="reference" href="#write-resume-data" id="id167" name="id167">write_resume_data()</a></li>
+<li><a class="reference" href="#move-slot" id="id168" name="id168">move_slot()</a></li>
+<li><a class="reference" href="#swap-slots" id="id169" name="id169">swap_slots()</a></li>
+<li><a class="reference" href="#swap-slots3" id="id170" name="id170">swap_slots3()</a></li>
+<li><a class="reference" href="#hash-for-slot" id="id171" name="id171">hash_for_slot()</a></li>
+<li><a class="reference" href="#release-files" id="id172" name="id172">release_files()</a></li>
+<li><a class="reference" href="#delete-files" id="id173" name="id173">delete_files()</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#queuing" id="id173" name="id173">queuing</a><ul>
-<li><a class="reference" href="#downloading" id="id174" name="id174">downloading</a></li>
-<li><a class="reference" href="#seeding" id="id175" name="id175">seeding</a></li>
+<li><a class="reference" href="#queuing" id="id174" name="id174">queuing</a><ul>
+<li><a class="reference" href="#downloading" id="id175" name="id175">downloading</a></li>
+<li><a class="reference" href="#seeding" id="id176" name="id176">seeding</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#fast-resume" id="id176" name="id176">fast resume</a><ul>
-<li><a class="reference" href="#file-format" id="id177" name="id177">file format</a></li>
+<li><a class="reference" href="#fast-resume" id="id177" name="id177">fast resume</a><ul>
+<li><a class="reference" href="#file-format" id="id178" name="id178">file format</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#threads" id="id178" name="id178">threads</a></li>
-<li><a class="reference" href="#storage-allocation" id="id179" name="id179">storage allocation</a><ul>
-<li><a class="reference" href="#sparse-allocation" id="id180" name="id180">sparse allocation</a></li>
-<li><a class="reference" href="#full-allocation" id="id181" name="id181">full allocation</a></li>
-<li><a class="reference" href="#compact-allocation" id="id182" name="id182">compact allocation</a></li>
+<li><a class="reference" href="#threads" id="id179" name="id179">threads</a></li>
+<li><a class="reference" href="#storage-allocation" id="id180" name="id180">storage allocation</a><ul>
+<li><a class="reference" href="#sparse-allocation" id="id181" name="id181">sparse allocation</a></li>
+<li><a class="reference" href="#full-allocation" id="id182" name="id182">full allocation</a></li>
+<li><a class="reference" href="#compact-allocation" id="id183" name="id183">compact allocation</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#extensions" id="id183" name="id183">extensions</a><ul>
-<li><a class="reference" href="#metadata-from-peers" id="id184" name="id184">metadata from peers</a></li>
-<li><a class="reference" href="#http-seeding" id="id185" name="id185">HTTP seeding</a></li>
+<li><a class="reference" href="#extensions" id="id184" name="id184">extensions</a><ul>
+<li><a class="reference" href="#metadata-from-peers" id="id185" name="id185">metadata from peers</a></li>
+<li><a class="reference" href="#http-seeding" id="id186" name="id186">HTTP seeding</a></li>
 </ul>
 </li>
-<li><a class="reference" href="#filename-checks" id="id186" name="id186">filename checks</a></li>
-<li><a class="reference" href="#acknowledgments" id="id187" name="id187">acknowledgments</a></li>
+<li><a class="reference" href="#filename-checks" id="id187" name="id187">filename checks</a></li>
+<li><a class="reference" href="#acknowledgments" id="id188" name="id188">acknowledgments</a></li>
 </ul>
 </div>
 <div class="section">
@@ -1658,11 +1659,13 @@ struct torrent_handle
 
         void piece_priority(int index, int priority) const;
         int piece_priority(int index) const;
-
         void prioritize_pieces(std::vector&lt;int&gt; const&amp; pieces) const;
         std::vector&lt;int&gt; piece_priorities() const;
 
+        void file_priority(int index, int priority) const;
+        int file_priority(int index) const;
         void prioritize_files(std::vector&lt;int&gt; const&amp; files) const;
+        std::vector&lt;int&gt; file_priorities() const;
 
         bool is_auto_managed() const;
         void auto_managed(bool m) const;
@@ -1692,14 +1695,13 @@ Since the torrents are processed by a background thread, there is no
 guarantee that a handle will remain valid between two calls.</p>
 </div>
 <div class="section">
-<h2><a id="piece-priority-prioritize-pieces-piece-priorities-prioritize-files" name="piece-priority-prioritize-pieces-piece-priorities-prioritize-files">piece_priority() prioritize_pieces() piece_priorities() prioritize_files()</a></h2>
+<h2><a id="piece-priority-prioritize-pieces-piece-priorities" name="piece-priority-prioritize-pieces-piece-priorities">piece_priority() prioritize_pieces() piece_priorities()</a></h2>
 <blockquote>
 <pre class="literal-block">
 void piece_priority(int index, int priority) const;
 int piece_priority(int index) const;
 void prioritize_pieces(std::vector&lt;int&gt; const&amp; pieces) const;
 std::vector&lt;int&gt; piece_priorities() const;
-void prioritize_files(std::vector&lt;int&gt; const&amp; files) const;
 </pre>
 </blockquote>
 <p>These functions are used to set and get the prioritiy of individual pieces.
@@ -1732,9 +1734,27 @@ the torrent. All the piece priorities will be updated with the priorities
 in the vector.</p>
 <p><tt class="docutils literal"><span class="pre">piece_priorities</span></tt> returns a vector with one element for each piece in the
 torrent. Each element is the current priority of that piece.</p>
+</div>
+<div class="section">
+<h2><a id="file-priority-prioritize-files-file-priorities" name="file-priority-prioritize-files-file-priorities">file_priority() prioritize_files() file_priorities()</a></h2>
+<blockquote>
+<pre class="literal-block">
+void file_priority(int index, int priority) const;
+int file_priority(int index) const;
+void prioritize_files(std::vector&lt;int&gt; const&amp; files) const;
+std::vector&lt;int&gt; file_priorities() const;
+</pre>
+</blockquote>
+<p><tt class="docutils literal"><span class="pre">index</span></tt> must be in the range [0, number_of_files).</p>
+<p><tt class="docutils literal"><span class="pre">file_priority</span></tt> queries or sets the priority of file <tt class="docutils literal"><span class="pre">index</span></tt>.</p>
 <p><tt class="docutils literal"><span class="pre">prioritize_files</span></tt> takes a vector that has at as many elements as there are
 files in the torrent. Each entry is the priority of that file. The function
 sets the priorities of all the pieces in the torrent based on the vector.</p>
+<p><tt class="docutils literal"><span class="pre">file_priorities</span></tt> returns a vector with the priorities of all files.</p>
+<p>The priority values are the same as for <tt class="docutils literal"><span class="pre">piece_priority</span></tt>.</p>
+<p>Whenever a file priority is changed, all other piece priorities are reset
+to match the file priorities. In order to maintain sepcial priorities for
+particular pieces, <tt class="docutils literal"><span class="pre">piece_priority</span></tt> has to be called again for those pieces.</p>
 </div>
 <div class="section">
 <h2><a id="file-progress" name="file-progress">file_progress()</a></h2>
diff --git a/docs/manual.rst b/docs/manual.rst
index d5ae6fe86..9cf20a2aa 100644
--- a/docs/manual.rst
+++ b/docs/manual.rst
@@ -1574,11 +1574,13 @@ Its declaration looks like this::
 
 		void piece_priority(int index, int priority) const;
 		int piece_priority(int index) const;
-
 		void prioritize_pieces(std::vector<int> const& pieces) const;
 		std::vector<int> piece_priorities() const;
 
+		void file_priority(int index, int priority) const;
+		int file_priority(int index) const;
 		void prioritize_files(std::vector<int> const& files) const;
+		std::vector<int> file_priorities() const;
 
 		bool is_auto_managed() const;
 		void auto_managed(bool m) const;
@@ -1607,8 +1609,8 @@ it will throw ``invalid_handle``.
 	guarantee that a handle will remain valid between two calls.
 
 
-piece_priority() prioritize_pieces() piece_priorities() prioritize_files()
---------------------------------------------------------------------------
+piece_priority() prioritize_pieces() piece_priorities()
+-------------------------------------------------------
 
 	::
 
@@ -1616,7 +1618,6 @@ piece_priority() prioritize_pieces() piece_priorities() prioritize_files()
 		int piece_priority(int index) const;
 		void prioritize_pieces(std::vector<int> const& pieces) const;
 		std::vector<int> piece_priorities() const;
-		void prioritize_files(std::vector<int> const& files) const;
 
 These functions are used to set and get the prioritiy of individual pieces.
 By default all pieces have priority 1. That means that the random rarest
@@ -1650,10 +1651,32 @@ in the vector.
 ``piece_priorities`` returns a vector with one element for each piece in the
 torrent. Each element is the current priority of that piece.
 
+
+file_priority() prioritize_files() file_priorities()
+----------------------------------------------------
+
+	::
+
+		void file_priority(int index, int priority) const;
+		int file_priority(int index) const;
+		void prioritize_files(std::vector<int> const& files) const;
+		std::vector<int> file_priorities() const;
+
+``index`` must be in the range [0, number_of_files).
+
+``file_priority`` queries or sets the priority of file ``index``.
+
 ``prioritize_files`` takes a vector that has at as many elements as there are
 files in the torrent. Each entry is the priority of that file. The function
 sets the priorities of all the pieces in the torrent based on the vector.
 
+``file_priorities`` returns a vector with the priorities of all files.
+
+The priority values are the same as for ``piece_priority``.
+
+Whenever a file priority is changed, all other piece priorities are reset
+to match the file priorities. In order to maintain sepcial priorities for
+particular pieces, ``piece_priority`` has to be called again for those pieces.
 
 file_progress()
 ---------------
diff --git a/include/libtorrent/torrent.hpp b/include/libtorrent/torrent.hpp
index b99e2d775..d6a0f9dd3 100644
--- a/include/libtorrent/torrent.hpp
+++ b/include/libtorrent/torrent.hpp
@@ -235,7 +235,13 @@ namespace libtorrent
 		void prioritize_pieces(std::vector<int> const& pieces);
 		void piece_priorities(std::vector<int>&) const;
 
+		void set_file_priority(int index, int priority);
+		int file_priority(int index) const;
+
 		void prioritize_files(std::vector<int> const& files);
+		void file_priorities(std::vector<int>&) const;
+
+		void update_piece_priorities();
 
 		torrent_status status() const;
 
@@ -770,6 +776,8 @@ namespace libtorrent
 		// this torrent belongs to.
 		aux::session_impl& m_ses;
 
+		std::vector<boost::uint8_t> m_file_priority;
+
 		boost::scoped_ptr<piece_picker> m_picker;
 
 		// the queue of peer_connections that want more bandwidth
diff --git a/include/libtorrent/torrent_handle.hpp b/include/libtorrent/torrent_handle.hpp
index a062580c2..b19b2a2a9 100644
--- a/include/libtorrent/torrent_handle.hpp
+++ b/include/libtorrent/torrent_handle.hpp
@@ -392,8 +392,12 @@ namespace libtorrent
 		void prioritize_pieces(std::vector<int> const& pieces) const;
 		std::vector<int> piece_priorities() const;
 
-		void prioritize_files(std::vector<int> const& files) const;
+		// priority must be within the range [0, 7]
+		void file_priority(int index, int priority) const;
+		int file_priority(int index) const;
 
+		void prioritize_files(std::vector<int> const& files) const;
+		std::vector<int> file_priorities() const;
 
 		// set the interface to bind outgoing connections
 		// to.
diff --git a/src/storage.cpp b/src/storage.cpp
index 96798db9c..ee29a958b 100644
--- a/src/storage.cpp
+++ b/src/storage.cpp
@@ -436,6 +436,7 @@ namespace libtorrent
 		boost::scoped_ptr<file_storage> m_mapped_files;
 		file_storage const& m_files;
 
+		std::vector<boost::uint8_t> m_file_priority;
 		fs::path m_save_path;
 		// the file pool is typically stored in
 		// the session, to make all storage
@@ -521,7 +522,10 @@ namespace libtorrent
 #ifndef BOOST_NO_EXCEPTIONS
 			try {
 #endif
-			if (allocate_files)
+			// don't allocate files with priority 0
+			int file_index = file_iter - files().begin();
+			if (allocate_files && (m_file_priority.size() <= file_index
+				|| m_file_priority[file_index] > 0))
 			{
 				error_code ec;
 				boost::shared_ptr<file> f = m_pool.open_file(this
@@ -543,6 +547,7 @@ namespace libtorrent
 			}
 #endif
 		}
+		std::vector<boost::uint8_t>().swap(m_file_priority);
 		// close files that were opened in write mode
 		m_pool.release(this);
 		return false;
@@ -702,6 +707,15 @@ namespace libtorrent
 
 	bool storage::verify_resume_data(lazy_entry const& rd, std::string& error)
 	{
+		lazy_entry const* file_priority = rd.dict_find_list("file_priority");
+		if (file_priority && file_priority->list_size()
+			== files().num_files())
+		{
+			m_file_priority.resize(file_priority->list_size());
+			for (int i = 0; i < file_priority->list_size(); ++i)
+				m_file_priority[i] = file_priority->list_int_value_at(i, 1);
+		}
+
 		lazy_entry const* mapped_files = rd.dict_find_list("mapped_files");
 		if (mapped_files && mapped_files->list_size() == m_files.num_files())
 		{
diff --git a/src/torrent.cpp b/src/torrent.cpp
index 3b82994de..d2e1b8064 100644
--- a/src/torrent.cpp
+++ b/src/torrent.cpp
@@ -424,6 +424,9 @@ namespace libtorrent
 		TORRENT_ASSERT(m_torrent_file->num_files() > 0);
 		TORRENT_ASSERT(m_torrent_file->total_size() >= 0);
 
+		m_file_priority.clear();
+		m_file_priority.resize(m_torrent_file->num_files(), 1);
+
 		m_block_size = (std::min)(m_block_size, m_torrent_file->piece_length());
 
 		if (m_torrent_file->num_pieces()
@@ -1771,17 +1774,49 @@ namespace libtorrent
 		// in the torrent
 		TORRENT_ASSERT(int(files.size()) == m_torrent_file->num_files());
 		
-		size_type position = 0;
-
 		if (m_torrent_file->num_pieces() == 0) return;
 
+		std::copy(files.begin(), files.end(), m_file_priority.begin());
+		update_piece_priorities();
+	}
+
+	void torrent::set_file_priority(int index, int prio)
+	{
+		INVARIANT_CHECK;
+		TORRENT_ASSERT(index < m_torrent_file->num_files());
+		TORRENT_ASSERT(index >= 0);
+		if (m_file_priority[index] == prio) return;
+		m_file_priority[index] = prio;
+		update_piece_priorities();
+	}
+	
+	int torrent::file_priority(int index) const
+	{
+		TORRENT_ASSERT(index < m_torrent_file->num_files());
+		TORRENT_ASSERT(index >= 0);
+		return m_file_priority[index];
+	}
+
+	void torrent::file_priorities(std::vector<int>& files) const
+	{
+		INVARIANT_CHECK;
+		files.resize(m_file_priority.size());
+		std::copy(m_file_priority.begin(), m_file_priority.end(), files.begin());
+	}
+
+	void torrent::update_piece_priorities()
+	{
+		INVARIANT_CHECK;
+
+		if (m_torrent_file->num_pieces() == 0) return;
 		bool was_finished = is_finished();
 
+		size_type position = 0;
 		int piece_length = m_torrent_file->piece_length();
 		// initialize the piece priorities to 0, then only allow
 		// setting higher priorities
 		std::vector<int> pieces(m_torrent_file->num_pieces(), 0);
-		for (int i = 0; i < int(files.size()); ++i)
+		for (int i = 0; i < int(m_file_priority.size()); ++i)
 		{
 			size_type start = position;
 			size_type size = m_torrent_file->files().at(i).size;
@@ -1792,12 +1827,12 @@ namespace libtorrent
 			// already set (to avoid problems with overlapping pieces)
 			int start_piece = int(start / piece_length);
 			int last_piece = int((position - 1) / piece_length);
-			TORRENT_ASSERT(last_piece <= int(pieces.size()));
+			TORRENT_ASSERT(last_piece < int(pieces.size()));
 			// if one piece spans several files, we might
 			// come here several times with the same start_piece, end_piece
 			std::for_each(pieces.begin() + start_piece
 				, pieces.begin() + last_piece + 1
-				, bind(&set_if_greater, _1, files[i]));
+				, bind(&set_if_greater, _1, m_file_priority[i]));
 		}
 		prioritize_pieces(pieces);
 		update_peer_interest(was_finished);
@@ -2442,6 +2477,14 @@ namespace libtorrent
 		set_max_connections(rd.dict_find_int_value("max_connections", -1));
 		set_max_uploads(rd.dict_find_int_value("max_uploads", -1));
 
+		lazy_entry const* file_priority = rd.dict_find_list("file_priority");
+		if (file_priority && file_priority->list_size()
+			== m_torrent_file->num_files())
+		{
+			for (int i = 0; i < file_priority->list_size(); ++i)
+				m_file_priority[i] = file_priority->list_int_value_at(i, 1);
+			update_piece_priorities();
+		}
 		lazy_entry const* piece_priority = rd.dict_find_string("piece_priority");
 		if (piece_priority && piece_priority->string_length()
 			== m_torrent_file->num_pieces())
@@ -2597,6 +2640,13 @@ namespace libtorrent
 			for (int i = 0, end(piece_priority.size()); i < end; ++i)
 				piece_priority[i] = m_picker->piece_priority(i);
 		}
+
+		// write file priorities
+		entry::list_type& file_priority = ret["file_priority"].list();
+		file_priority.clear();
+		for (int i = 0, end(m_file_priority.size()); i < end; ++i)
+			file_priority.push_back(m_file_priority[i]);
+
 	}
 
 	void torrent::get_full_peer_list(std::vector<peer_list_entry>& v) const
diff --git a/src/torrent_handle.cpp b/src/torrent_handle.cpp
index 4b8d8a452..e9f179e32 100644
--- a/src/torrent_handle.cpp
+++ b/src/torrent_handle.cpp
@@ -400,12 +400,32 @@ namespace libtorrent
 		return ret;
 	}
 
+	void torrent_handle::file_priority(int index, int priority) const
+	{
+		INVARIANT_CHECK;
+		TORRENT_FORWARD(set_file_priority(index, priority));
+	}
+
+	int torrent_handle::file_priority(int index) const
+	{
+		INVARIANT_CHECK;
+		TORRENT_FORWARD_RETURN(file_priority(index), 0);
+	}
+
 	void torrent_handle::prioritize_files(std::vector<int> const& files) const
 	{
 		INVARIANT_CHECK;
 		TORRENT_FORWARD(prioritize_files(files));
 	}
 
+	std::vector<int> torrent_handle::file_priorities() const
+	{
+		INVARIANT_CHECK;
+		std::vector<int> ret;
+		TORRENT_FORWARD_RETURN2(file_priorities(ret), ret);
+		return ret;
+	}
+
 // ============ start deprecation ===============
 
 	void torrent_handle::filter_piece(int index, bool filter) const