]> git.meshlink.io Git - catta/blob - avahi-common/alternative.h
improve documentation
[catta] / avahi-common / alternative.h
1 #ifndef fooalternativehfoo
2 #define fooalternativehfoo
3
4 /* $Id$ */
5
6 /***
7   This file is part of avahi.
8  
9   avahi is free software; you can redistribute it and/or modify it
10   under the terms of the GNU Lesser General Public License as
11   published by the Free Software Foundation; either version 2.1 of the
12   License, or (at your option) any later version.
13  
14   avahi is distributed in the hope that it will be useful, but WITHOUT
15   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
16   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
17   Public License for more details.
18  
19   You should have received a copy of the GNU Lesser General Public
20   License along with avahi; if not, write to the Free Software
21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22   USA.
23 ***/
24
25 #include <glib.h>
26
27 #include <avahi-common/cdecl.h>
28
29 /** \file alternative.h Functions to find alternative names for hosts and services in the case of name collision */
30
31 AVAHI_C_DECL_BEGIN
32
33 /** Find an alternative for the specified host name. If called with an
34  * original host name, "2" is appended, Afterwards the number is
35  * increased on each call. (i.e. "foo" becomes "foo2" becomes "foo3"
36  * and so on.)*/
37 gchar *avahi_alternative_host_name(const gchar *s);
38
39 /** Find an alternative for the specified service name. If called with
40     an original service name, " #2" is appended. Afterwards the number
41     is increased on each call (i.e. "foo" becomes "foo #2" becomes
42     "foo #3" and so on.)*/
43 gchar *avahi_alternative_service_name(const gchar *s);
44
45 AVAHI_C_DECL_END
46
47 #endif