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>