transmission/libtransmission/clients.h

// This file Copyright © 2008-2023 Mnemosyne LLC.
// It may be used under GPLv2 (SPDX: GPL-2.0-only), GPLv3 (SPDX: GPL-3.0-only),
// or any future license endorsed by Mnemosyne LLC.
// License text can be found in the licenses/ folder.

#pragma once

#ifndef __TRANSMISSION__
#error only libtransmission should #include this header.
#endif

#include <cstddef> // size_t

#include "tr-macros.h" // tr_peer_id_t

/**
 * @brief parse a peer-id into a human-readable client name and version number
 * @ingroup utils
 */
void tr_clientForId(char* buf, size_t buflen, tr_peer_id_t peer_id);
chore: update copyrights to 2023 (#4834) 2023-02-11 21:49:42 +01:00			`// This file Copyright © 2008-2023 Mnemosyne LLC.`
chore: fix spdx abbreviations (#3602) 2022-08-08 13:05:39 -05:00			`// It may be used under GPLv2 (SPDX: GPL-2.0-only), GPLv3 (SPDX: GPL-3.0-only),`
chore: update copyright years, make notices consistent (#2463) 2022-01-20 12:27:56 -06:00			`// or any future license endorsed by Mnemosyne LLC.`
			`// License text can be found in the licenses/ folder.`
Revert [619] 2006-07-16 19:39:23 +00:00
Ensure include guard is the first non-comment line 2017-11-14 23:21:28 +03:00			`#pragma once`

(trunk) add #include guards to prevent non-libtransmission files from #including implementation headers 2009-12-15 00:51:39 +00:00			`#ifndef __TRANSMISSION__`
Adjust uncrustify config, reformat all but Mac client There're places where manual intervention is still required as uncrustify is not ideal (unfortunately), but at least one may rely on it to do the right thing most of the time (e.g. when sending in a patch). The style itself is quite different from what we had before but making it uniform across all the codebase is the key. I also hope that it'll make the code more readable (YMMV) and less sensitive to further changes. 2017-04-19 15:04:45 +03:00			`#error only libtransmission should #include this header.`
(trunk) add #include guards to prevent non-libtransmission files from #including implementation headers 2009-12-15 00:51:39 +00:00			`#endif`

refactor: tidy libtransmission includes (#2316) 2021-12-15 15:25:42 -06:00			`#include <cstddef> // size_t`

refactor: simplify tr_clientForId() (#3751) * refactor: use make buf_append() a template function; use libfmt * refactor: make charint() use a lookup table * chore: use std::equal instead of strncmp 2022-09-03 02:13:22 -05:00			`#include "tr-macros.h" // tr_peer_id_t`
refactor: use GTest for running tests (#1383) * refactor: use google-test on libtransmission tests 2020-08-11 13:11:55 -05:00
(trunk libT) re-start work on making libT doxygen friendly. still a long ways to go on this. 2009-05-29 19:17:12 +00:00			`/**`
(trunk) No code changes here... filling in some of the blanks in the "peers" and "utils" doxygen groups' documentation. 2010-01-19 19:37:00 +00:00			`* @brief parse a peer-id into a human-readable client name and version number`
(trunk libT) re-start work on making libT doxygen friendly. still a long ways to go on this. 2009-05-29 19:17:12 +00:00			`* @ingroup utils`
			`*/`
refactor: simplify tr_clientForId() (#3751) * refactor: use make buf_append() a template function; use libfmt * refactor: make charint() use a lookup table * chore: use std::equal instead of strncmp 2022-09-03 02:13:22 -05:00			`void tr_clientForId(char* buf, size_t buflen, tr_peer_id_t peer_id);`