sjero.net Git - wget/blob - src/url.h

   1 /* Declarations for url.c.
   2    Copyright (C) 1996-2006 Free Software Foundation, Inc.
   3
   4 This file is part of GNU Wget.
   5
   6 GNU Wget is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 3 of the License, or
   9 (at your option) any later version.
  10
  11 GNU Wget is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with Wget.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 In addition, as a special exception, the Free Software Foundation
  20 gives permission to link the code of its release of Wget with the
  21 OpenSSL project's "OpenSSL" library (or with modified versions of it
  22 that use the same license as the "OpenSSL" library), and distribute
  23 the linked executables.  You must obey the GNU General Public License
  24 in all respects for all of the code used other than "OpenSSL".  If you
  25 modify this file, you may extend this exception to your version of the
  26 file, but you are not obligated to do so.  If you do not wish to do
  27 so, delete this exception statement from your version.  */
  28
  29 #ifndef URL_H
  30 #define URL_H
  31
  32 /* Default port definitions */
  33 #define DEFAULT_HTTP_PORT 80
  34 #define DEFAULT_FTP_PORT 21
  35 #define DEFAULT_HTTPS_PORT 443
  36
  37 /* Note: the ordering here is related to the order of elements in
  38    `supported_schemes' in url.c.  */
  39
  40 enum url_scheme {
  41   SCHEME_HTTP,
  42 #ifdef HAVE_SSL
  43   SCHEME_HTTPS,
  44 #endif
  45   SCHEME_FTP,
  46   SCHEME_INVALID
  47 };
  48
  49 /* Structure containing info on a URL.  */
  50 struct url
  51 {
  52   char *url;                    /* Original URL */
  53   enum url_scheme scheme;       /* URL scheme */
  54
  55   char *host;                   /* Extracted hostname */
  56   int port;                     /* Port number */
  57
  58   /* URL components (URL-quoted). */
  59   char *path;
  60   char *params;
  61   char *query;
  62   char *fragment;
  63
  64   /* Extracted path info (unquoted). */
  65   char *dir;
  66   char *file;
  67
  68   /* Username and password (unquoted). */
  69   char *user;
  70   char *passwd;
  71 };
  72
  73 /* Function declarations */
  74
  75 char *url_escape (const char *);
  76
  77 struct url *url_parse (const char *, int *);
  78 const char *url_error (int);
  79 char *url_full_path (const struct url *);
  80 void url_set_dir (struct url *, const char *);
  81 void url_set_file (struct url *, const char *);
  82 void url_free (struct url *);
  83
  84 enum url_scheme url_scheme (const char *);
  85 bool url_has_scheme (const char *);
  86 int scheme_default_port (enum url_scheme);
  87 void scheme_disable (enum url_scheme);
  88
  89 char *url_string (const struct url *, bool);
  90 char *url_file_name (const struct url *);
  91
  92 char *uri_merge (const char *, const char *);
  93
  94 int mkalldirs (const char *);
  95
  96 char *rewrite_shorthand_url (const char *);
  97 bool schemes_are_similar_p (enum url_scheme a, enum url_scheme b);
  98
  99 bool are_urls_equal (const char *u1, const char *u2);
 100
 101 #endif /* URL_H */