source: trunk/libtransmission/platform.h @ 11599

Last change on this file since 11599 was 11599, checked in by charles, 11 years ago

(trunk) Join the 21st century and use only 1 space at the end sentences. This commit is nearly as important as the semi-annual ones that remove trailing spaces from the ends of lines of code... :)

  • Property svn:keywords set to Date Rev Author Id
File size: 2.4 KB
Line 
1/*
2 * This file Copyright (C) 2009-2010 Mnemosyne LLC
3 *
4 * This file is licensed by the GPL version 2. Works owned by the
5 * Transmission project are granted a special exemption to clause 2(b)
6 * so that the bulk of its code can remain under the MIT license.
7 * This exemption does not extend to derived works not owned by
8 * the Transmission project.
9 *
10 * $Id: platform.h 11599 2010-12-27 19:18:17Z charles $
11 */
12
13#ifndef __TRANSMISSION__
14 #error only libtransmission should #include this header.
15#endif
16
17#ifndef TR_PLATFORM_H
18#define TR_PLATFORM_H
19
20#define TR_PATH_DELIMITER '/'
21#define TR_PATH_DELIMITER_STR "/"
22
23#ifdef WIN32
24 #include <windef.h> /* MAX_PATH */
25 #define TR_PATH_MAX (MAX_PATH + 1)
26#else
27 #include <limits.h> /* PATH_MAX */
28 #ifdef PATH_MAX
29  #define TR_PATH_MAX PATH_MAX
30 #else
31  #define TR_PATH_MAX 4096
32 #endif
33#endif
34
35/**
36 * @addtogroup tr_session Session
37 * @{
38 */
39
40/**
41 * @brief invoked by tr_sessionInit() to set up the locations of the resume, torrent, and clutch directories.
42 * @see tr_getResumeDir()
43 * @see tr_getTorrentDir()
44 * @see tr_getWebClientDir()
45 */
46void tr_setConfigDir( tr_session * session, const char * configDir );
47
48/** @brief return the directory where .resume files are stored */
49const char * tr_getResumeDir( const tr_session * );
50
51/** @brief return the directory where .torrent files are stored */
52const char * tr_getTorrentDir( const tr_session * );
53
54/** @brief return the directory where the Web Client's web ui files are kept */
55const char * tr_getWebClientDir( const tr_session * );
56
57/** @} */
58
59
60/**
61 * @addtogroup utils Utilities
62 * @{
63 */
64
65typedef struct tr_thread tr_thread;
66
67/** @brief Instantiate a new process thread */
68tr_thread* tr_threadNew( void ( *func )(void *), void * arg );
69
70/** @brief Return nonzero if this function is being called from `thread'
71    @param thread the thread being tested */
72tr_bool tr_amInThread( const tr_thread * );
73
74/***
75****
76***/
77
78typedef struct tr_lock tr_lock;
79
80/** @brief Create a new thread mutex object */
81tr_lock * tr_lockNew( void );
82
83/** @brief Destroy a thread mutex object */
84void tr_lockFree( tr_lock * );
85
86/** @brief Attempt to lock a thread mutex object */
87void tr_lockLock( tr_lock * );
88
89/** @brief Unlock a thread mutex object */
90void tr_lockUnlock( tr_lock * );
91
92/** @brief return nonzero if the specified lock is locked */
93int tr_lockHave( const tr_lock * );
94
95#ifdef WIN32
96void * mmap( void *ptr, long  size, long  prot, long  type, long  handle, long  arg );
97
98long munmap( void *ptr, long  size );
99#endif
100
101/* @} */
102
103#endif
Note: See TracBrowser for help on using the repository browser.