| 635 * |
635 * |
| 636 * Either @a fd must be specified <i>or</i> @a ip and @a port on a |
636 * Either @a fd must be specified <i>or</i> @a ip and @a port on a |
| 637 * file receive transfer. On send, @a fd must be specified, and |
637 * file receive transfer. On send, @a fd must be specified, and |
| 638 * @a ip and @a port are ignored. |
638 * @a ip and @a port are ignored. |
| 639 * |
639 * |
| 640 * Prior to libpurple 2.6.0, passing '0' to @a fd was special-cased to |
640 * Passing @a fd as '-1' is a special-case and indicates to the |
| 641 * allow the protocol plugin to facilitate the file transfer itself. As of |
641 * protocol plugin to facilitate the file transfer itself. |
| 642 * 2.6.0, this is supported (for backward compatibility), but will be |
|
| 643 * removed in libpurple 3.0.0. If a prpl detects that the running libpurple |
|
| 644 * is running 2.6.0 or higher, it should use the invalid fd '-1'. |
|
| 645 * |
642 * |
| 646 * @param xfer The file transfer. |
643 * @param xfer The file transfer. |
| 647 * @param fd The file descriptor for the socket. |
644 * @param fd The file descriptor for the socket. |
| 648 * @param ip The IP address to connect to. |
645 * @param ip The IP address to connect to. |
| 649 * @param port The port to connect to. |
646 * @param port The port to connect to. |