symbols.pl (2857B)
1 #!/usr/bin/env perl 2 #*************************************************************************** 3 # _ _ ____ _ 4 # Project ___| | | | _ \| | 5 # / __| | | | |_) | | 6 # | (__| |_| | _ <| |___ 7 # \___|\___/|_| \_\_____| 8 # 9 # Copyright (C) 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.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 # SPDX-License-Identifier: curl 23 # 24 ########################################################################### 25 # 26 # Experience has shown that the symbols-in-versions file is useful to 27 # applications that want to build with a wide range of libcurl versions. It 28 # is however easy to get it wrong and the source gets a bit messy with all the 29 # fixed numerical comparisons. 30 # 31 # The point of this script is to provide an easy-to-use macro for libcurl- 32 # using applications to do preprocessor checks for specific libcurl defines, 33 # and yet make the code clearly show what the macro is used for. 34 # 35 # Run this script and generate libcurl-symbols.h and then use that header in 36 # a fashion similar to: 37 # 38 # #include "libcurl-symbols.h" 39 # 40 # #if LIBCURL_HAS(CURLOPT_MUTE) 41 # has mute 42 # #else 43 # no mute 44 # #endif 45 # 46 # 47 open F, "<symbols-in-versions"; 48 49 sub str2num { 50 my ($str)=@_; 51 if($str =~ /([0-9]*)\.([0-9]*)\.*([0-9]*)/) { 52 return sprintf("0x%06x", $1<<16 | $2 << 8 | $3); 53 } 54 } 55 56 print <<EOS 57 58 #include <curl/curl.h> 59 60 #define LIBCURL_HAS(x) \\ 61 (defined(x ## _FIRST) && (x ## _FIRST <= LIBCURL_VERSION_NUM) && \\ 62 (!defined(x ## _LAST) || ( x ## _LAST >= LIBCURL_VERSION_NUM))) 63 64 EOS 65 ; 66 67 while(<F>) { 68 if(/^(CURL[^ ]*)[ \t]*(.*)/) { 69 my ($sym, $vers)=($1, $2); 70 71 my $intr; 72 my $rm; 73 my $dep; 74 75 # is there removed info? 76 if($vers =~ /([\d.]+)[ \t-]+([\d.-]+)[ \t]+([\d.]+)/) { 77 ($intr, $dep, $rm)=($1, $2, $3); 78 } 79 # is it a dep-only line? 80 elsif($vers =~ /([\d.]+)[ \t-]+([\d.]+)/) { 81 ($intr, $dep)=($1, $2); 82 } 83 else { 84 $intr = $vers; 85 } 86 87 my $inum = str2num($intr); 88 89 print <<EOS 90 #define ${sym}_FIRST $inum /* Added in $intr */ 91 EOS 92 ; 93 my $irm = str2num($rm); 94 if($rm) { 95 print <<EOS 96 #define ${sym}_LAST $irm /* Last featured in $rm */ 97 EOS 98 ; 99 } 100 101 } 102 }