Return to symbols.pl CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs / libcurl

Annotation of embedaddon/curl/docs/libcurl/symbols.pl, revision 1.1

1.1     ! misho       1: #!/usr/bin/env perl
        !             2: #***************************************************************************
        !             3: #                                  _   _ ____  _
        !             4: #  Project                     ___| | | |  _ \| |
        !             5: #                             / __| | | | |_) | |
        !             6: #                            | (__| |_| |  _ <| |___
        !             7: #                             \___|\___/|_| \_\_____|
        !             8: #
        !             9: # Copyright (C) 2011 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
        !            10: #
        !            11: # This software is licensed as described in the file COPYING, which
        !            12: # you should have received as part of this distribution. The terms
        !            13: # are also available at https://curl.haxx.se/docs/copyright.html.
        !            14: #
        !            15: # You may opt to use, copy, modify, merge, publish, distribute and/or sell
        !            16: # copies of the Software, and permit persons to whom the Software is
        !            17: # furnished to do so, under the terms of the COPYING file.
        !            18: #
        !            19: # This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
        !            20: # KIND, either express or implied.
        !            21: #
        !            22: ###########################################################################
        !            23: #
        !            24: # Experience has shown that the symbols-in-versions file is very useful to
        !            25: # applications that want to build with a wide range of libcurl versions.
        !            26: # It is however easy to get it wrong and the source gets a bit messy with all
        !            27: # the fixed numerical comparisons.
        !            28: #
        !            29: # The point of this script is to provide an easy-to-use macro for libcurl-
        !            30: # using applications to do preprocessor checks for specific libcurl defines,
        !            31: # and yet make the code clearly show what the macro is used for.
        !            32: #
        !            33: # Run this script and generate libcurl-symbols.h and then use that header in
        !            34: # a fashion similar to:
        !            35: #
        !            36: # #include "libcurl-symbols.h"
        !            37: #
        !            38: # #if LIBCURL_HAS(CURLOPT_MUTE)
        !            39: #   has mute
        !            40: # #else
        !            41: #   no mute
        !            42: # #endif
        !            43: #
        !            44: #
        !            45: open F, "<symbols-in-versions";
        !            46: 
        !            47: sub str2num {
        !            48:     my ($str)=@_;
        !            49:     if($str =~ /([0-9]*)\.([0-9]*)\.*([0-9]*)/) {
        !            50:         return sprintf("0x%06x", $1<<16 | $2 << 8 | $3);
        !            51:     }
        !            52: }
        !            53: 
        !            54: print <<EOS
        !            55: 
        !            56: #include <curl/curl.h>
        !            57: 
        !            58: #define LIBCURL_HAS(x) \\
        !            59:   (defined(x ## _FIRST) && (x ## _FIRST <= LIBCURL_VERSION_NUM) && \\
        !            60:    (!defined(x ## _LAST) || ( x ## _LAST >= LIBCURL_VERSION_NUM)))
        !            61: 
        !            62: EOS
        !            63:     ;
        !            64: 
        !            65: while(<F>) {
        !            66:     if(/^(CURL[^ ]*)[ \t]*(.*)/) {
        !            67:         my ($sym, $vers)=($1, $2);
        !            68: 
        !            69:         my $intr;
        !            70:         my $rm;
        !            71:         my $dep;
        !            72: 
        !            73:         # is there removed info?
        !            74:         if($vers =~ /([\d.]+)[ \t-]+([\d.-]+)[ \t]+([\d.]+)/) {
        !            75:             ($intr, $dep, $rm)=($1, $2, $3);
        !            76:         }
        !            77:         # is it a dep-only line?
        !            78:         elsif($vers =~ /([\d.]+)[ \t-]+([\d.]+)/) {
        !            79:             ($intr, $dep)=($1, $2);
        !            80:         }
        !            81:         else {
        !            82:             $intr = $vers;
        !            83:         }
        !            84: 
        !            85:         my $inum = str2num($intr);
        !            86: 
        !            87:         print <<EOS
        !            88: #define ${sym}_FIRST $inum /* Added in $intr */
        !            89: EOS
        !            90: ;
        !            91:         my $irm = str2num($rm);
        !            92:         if($rm) {
        !            93:         print <<EOS
        !            94: #define ${sym}_LAST $irm /* Last featured in $rm */
        !            95: EOS
        !            96: ;
        !            97:         }
        !            98: 
        !            99:     }
        !           100: }