Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GUTENFETCH_LIST_SERVERS(3)  Library Functions Manual  GUTENFETCH_LIST_SERVERS(3)

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),	  guten-
     fetch_get_aussie_server   (3),   gutenfetch_set_active_server  (3),  guten-
     fetch_set_active_server_full (3), gutenfetch_new_server (3), gutenfetch_du-
     plicate_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 un-
     der 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  FIT-
     NESS 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gutenfetch_list_servers&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help