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

   1 /* Declarations for url.c.
   2    Copyright (C) 1995, 1996, 1997 Free Software Foundation, Inc.
   3
   4 This file is part of Wget.
   5
   6 This program 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 2 of the License, or
   9 (at your option) any later version.
  10
  11 This program 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 this program; if not, write to the Free Software
  18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19
  20 #ifndef URL_H
  21 #define URL_H
  22
  23 /* If the string contains unsafe characters, duplicate it with
  24    encode_string, otherwise just copy it with strdup.  */
  25 #define CLEANDUP(x) (contains_unsafe (x) ? encode_string (x) : xstrdup (x))
  26
  27 /* Structure containing info on a URL.  */
  28 struct urlinfo
  29 {
  30   char *url;                    /* Unchanged URL */
  31   uerr_t proto;                 /* URL protocol */
  32   char *host;                   /* Extracted hostname */
  33   unsigned short port;
  34   char ftp_type;
  35   char *path, *dir, *file, *qstring;
  36                                 /* Path, dir, file, and query string
  37                                    (properly decoded) */
  38   char *user, *passwd;          /* Username and password */
  39   struct urlinfo *proxy;        /* The exact string to pass to proxy
  40                                    server */
  41   char *referer;                /* The source from which the request
  42                                    URI was obtained */
  43   char *local;                  /* The local filename of the URL
  44                                    document */
  45 };
  46
  47 enum uflags
  48 {
  49   URELATIVE     = 0x0001,      /* Is URL relative? */
  50   UNOPROTO      = 0x0002,      /* Is URL without a protocol? */
  51   UABS2REL      = 0x0004,      /* Convert absolute to relative? */
  52   UREL2ABS      = 0x0008       /* Convert relative to absolute? */
  53 };
  54
  55 /* A structure that defines the whereabouts of a URL, i.e. its
  56    position in an HTML document, etc.  */
  57 typedef struct _urlpos
  58 {
  59   char *url;                   /* URL */
  60   char *local_name;            /* Local file to which it was saved */
  61   enum uflags flags;           /* Various flags */
  62   int pos, size;               /* Relative position in the buffer */
  63   struct _urlpos *next;        /* Next struct in list */
  64 } urlpos;
  65
  66 /* downloaded_file() takes a parameter of this type and returns this type. */
  67 typedef enum
  68 {
  69   /* Return enumerators: */
  70   FILE_NOT_ALREADY_DOWNLOADED = 0,
  71
  72   /* Return / parameter enumerators: */
  73   FILE_DOWNLOADED_NORMALLY,
  74   FILE_DOWNLOADED_AND_HTML_EXTENSION_ADDED,
  75
  76   /* Parameter enumerators: */
  77   CHECK_FOR_FILE
  78 } downloaded_file_t;
  79
  80 /* Function declarations */
  81
  82 int skip_url PARAMS ((const char *));
  83
  84 int contains_unsafe PARAMS ((const char *));
  85 char *encode_string PARAMS ((const char *));
  86
  87 struct urlinfo *newurl PARAMS ((void));
  88 void freeurl PARAMS ((struct urlinfo *, int));
  89 uerr_t urlproto PARAMS ((const char *));
  90 int skip_proto PARAMS ((const char *));
  91 int skip_uname PARAMS ((const char *));
  92
  93 uerr_t parseurl PARAMS ((const char *, struct urlinfo *, int));
  94 char *str_url PARAMS ((const struct urlinfo *, int));
  95 int url_equal PARAMS ((const char *, const char *));
  96
  97 urlpos *get_urls_file PARAMS ((const char *));
  98 urlpos *get_urls_html PARAMS ((const char *, const char *, int, int));
  99 void free_urlpos PARAMS ((urlpos *));
 100
 101 void rotate_backups PARAMS ((const char *));
 102 int mkalldirs PARAMS ((const char *));
 103 char *url_filename PARAMS ((const struct urlinfo *));
 104 void opt_url PARAMS ((struct urlinfo *));
 105
 106 char *getproxy PARAMS ((uerr_t));
 107 int no_proxy_match PARAMS ((const char *, const char **));
 108
 109 void convert_links PARAMS ((const char *, urlpos *));
 110 urlpos *add_url PARAMS ((urlpos *, const char *, const char *));
 111
 112 downloaded_file_t downloaded_file PARAMS ((downloaded_file_t, const char *));
 113
 114 #endif /* URL_H */