[][src]Function transmission_sys::tr_sessionSetIncompleteDir

pub unsafe extern "C" fn tr_sessionSetIncompleteDir(
    session: *mut tr_session,
    dir: *const c_char
)

@brief set the per-session incomplete download folder.

When you add a new torrent and the session's incomplete directory is enabled, the new torrent will start downloading into that directory, and then be moved to tr_torrent.downloadDir when the torrent is finished downloading.

Torrents aren't moved as a result of changing the session's incomplete dir -- it's applied to new torrents, not existing ones.

tr_torrentSetLocation() overrules the incomplete dir: when a user specifies a new location, that becomes the torrent's new downloadDir and the torrent is moved there immediately regardless of whether or not it's complete.

@see tr_sessionInit() @see tr_sessionGetIncompleteDir() @see tr_sessionSetIncompleteDirEnabled() @see tr_sessionGetIncompleteDirEnabled()