comparison src/ft.h @ 6269:0a902bd3e170

[gaim-migrate @ 6766] I'm going to be boiled alive for this.. Changing gaim_xfers_get_local_system_ip() to use a static buffer that it returns instead of a g_strdup()'d copy of the buffer... but that's rarely of use, because I don't think the IP will be changing often enough where this will screw up code :P Also, fixed a function's name, because I broke compiling again. committer: Tailor Script <[e-mail]>

6268:084e1f6610a8

const char *gaim_xfers_get_local_ip(void);

/**
 * Returns the IP address of the local system.
 *
 * @note The returned IP address must be g_free()'d when no longer
 *       in use.
 *
 * @return The local IP address.
 */
char *gaim_xfers_get_local_system__ip(void);

/**
 * Returns the IP address that should be used for the specified account.
 *
 * First, the IP associated with @a account is tried, via a call to
 * gaim_account_get_local_ip().
 *
 * If that IP is not set, the IP set in preferences is tried.
 *
 * If that IP is not set, the system's local IP is tried, via a call to
 * gaim_xfers_get_local_ip().
 *
 * @note The returned IP address must be g_free()'d when no longer
 *       in use.
 *
 * @param account The account the IP is going to be used with.
 *
 * @return The local IP address to be used.
 */
char *gaim_xfers_get_ip_for_account(const GaimAccount *account);

/**
 * Initializes the file transfer subsystem.
 */
void gaim_xfers_init(void);

6269:0a902bd3e170

const char *gaim_xfers_get_local_ip(void);

/**
 * Returns the IP address of the local system.
 *
 * @note The returned string is a pointer to a static buffer. If this
 *       function is called twice, it may be important to make a copy
 *       of the returned string.
 *
 * @return The local IP address.
 */
const char *gaim_xfers_get_local_system_ip(void);

/**
 * Returns the IP address that should be used for the specified account.
 *
 * First, the IP associated with @a account is tried, via a call to
 * gaim_account_get_local_ip().
 *
 * If that IP is not set, the IP set in preferences is tried.
 *
 * If that IP is not set, the system's local IP is tried, via a call to
 * gaim_xfers_get_local_ip().
 *
 * @note The returned IP address must be g_free()'d when no longer
 *       in use.
 *
 * @note The returned string is a pointer to a static buffer. If this
 *       function is called twice, it may be important to make a copy
 *       of the returned string.
 *
 * @return The local IP address to be used.
 */
const char *gaim_xfers_get_ip_for_account(const GaimAccount *account);

/**
 * Initializes the file transfer subsystem.
 */
void gaim_xfers_init(void);