DragonFly On-Line Manual Pages
GUTENFETCH_LIST_SERVERS(3) DragonFly Library Functions Manual
NAME
gutenfetch_list_servers -- List all available project gutenberg
servers.
SYNOPSIS
#include <gutenfetch.h>
gutenfetch_server_t **
gutenfetch_list_servers( gutenfetch_continent_t );
typedef enum {
NORTH_AMERICA,
SOUTH_AMERICA,
EUROPE,
AFRICA,
ASIA,
AUSTRALASIA_OCEANIA,
NUM_OF_CONTINENTS,
ALL_CONTINENTS,
UNKNOWN_CONTINENT
} gutenfetch_continent_t;
typedef struct {
char *host;
char *name;
char *area;
gutenfetch_continent_t continent;
} gutenfetch_server_t;
DESCRIPTION
This function takes as a parameter a continent, one of NORTH_AMERICA,
SOUTH_AMERICA, EUROPE, AFRICA, ASIA, AUSTRALASIA_OCEANIA or
ALL_CONTINENTS. It then returns a NULL-terminated array of
gutenfetch_server_t * which match the supplied continent parameter.
This array must be freed when no longer in use by calling
gutenfetch_free_servers().
SEE ALSO
libgutenfetch (3), gutenfetch_get_active_server (3),
gutenfetch_get_aussie_server (3), gutenfetch_set_active_server (3),
gutenfetch_set_active_server_full (3), gutenfetch_new_server (3),
gutenfetch_duplicate_server (3), gutenfetch_free_server (3),
gutenfetch_free_servers (3)
COPYRIGHT
libgutenfetch is Copyright (C) 2004 Russell Francis.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
BUGS
Probably, if you find them please take the time to let me know about
them by filling out a bug report at the following URL.
http://www.sourceforge.net/tracker/?group_id=104733&func=browse
AUTHORS
Russell Francis <johntabularasa@users.sf.net>
libgutenfetch 1.1 11 July 2004 GUTENFETCH_LIST_SERVERS(3)