home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 June / PCWorld_2005-06_cd.bin / software / vyzkuste / firewally / firewally.exe / framework-2.3.exe / version.h < prev    next >
Text File  |  2004-01-30  |  13KB  |  309 lines
  1. /* version.h -- Cygwin version numbers and accompanying documentation.
  2.  
  3.    Copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003 Red Hat, Inc.
  4.  
  5. This file is part of Cygwin.
  6.  
  7. This software is a copyrighted work licensed under the terms of the
  8. Cygwin license.  Please consult the file "CYGWIN_LICENSE" for
  9. details. */
  10.  
  11. /* Cygwin versioning is relatively complicated because of its status
  12.    as a shared library.  Let's start with how versioning used to be done.
  13.  
  14.    Historical versioning in Cygwin 16.0 to 19.5:
  15.  
  16.    In the olden days of Cygwin, we had a dll major and minor version
  17.    and a registry version.  The major number started at 16 because the
  18.    "b15" GNU-Win32 release of the compiler tools was out when this
  19.    scheme was started.  We incremented the DLL name frequently (for
  20.    every official release) and towards the end of this period every
  21.    release used a different shared memory area to prevent DLLs from
  22.    interfering with each other (embedding a build timestamp into the
  23.    name of the shared memory area).  This turned out to be a Bad Idea
  24.    (tm) because people needed to mingle separate releases and have
  25.    them work together more than we thought they would.  This was
  26.    especially problematic when tty info needed to be retained when an
  27.    old Cygwin executable executed a newer one.
  28.  
  29.    In the old scheme, we incremented the major number whenever a
  30.    change to the dll invalidated existing executables.  This can
  31.    happen for a number of reasons, including when functions are
  32.    removed from the export list of the dll.  The minor number was
  33.    incremented when a change was made that we wanted to record, but
  34.    that didn't invalidate existing executables.  Both numbers were
  35.    recorded in the executable and in the dll.
  36.  
  37.    In October 1998 (starting with Cygwin 19.6), we started a new method
  38.    of Cygwin versioning: */
  39.  
  40.       /* The DLL major and minor numbers correspond to the "version of
  41.      the Cygwin shared library".  This version is used to track important
  42.      changes to the DLL and is mainly informative in nature. */
  43.  
  44. #define CYGWIN_VERSION_DLL_MAJOR 1005
  45. #define CYGWIN_VERSION_DLL_MINOR 7
  46.  
  47.       /* Major numbers before CYGWIN_VERSION_DLL_EPOCH are
  48.      incompatible. */
  49.  
  50. #define CYGWIN_VERSION_DLL_EPOCH 19
  51.  
  52.       /* CYGWIN_VERSION_DLL_COMBINED gives us a single number
  53.      representing the combined DLL major and minor numbers. */
  54.  
  55.       /* WATCH OUT FOR OCTAL!  Don't use, say, "00020" for 0.20 */
  56.  
  57. #define CYGWIN_VERSION_DLL_MAKE_COMBINED(maj, min) (((maj) * 1000) + min)
  58. #define CYGWIN_VERSION_DLL_COMBINED \
  59.   CYGWIN_VERSION_DLL_MAKE_COMBINED (CYGWIN_VERSION_DLL_MAJOR, CYGWIN_VERSION_DLL_MINOR)
  60.  
  61.      /* Every version of cygwin <= this uses an old, incorrect method
  62.     to determine signal masks. */
  63.  
  64. #define CYGWIN_VERSION_DLL_BAD_SIGNAL_MASK    19005
  65.  
  66.     /* API versions <= this had a termios structure whose members were
  67.        too small to accomodate modern settings. */
  68. #define CYGWIN_VERSION_DLL_OLD_TERMIOS        5
  69. #define CYGWIN_VERSION_DLL_IS_OLD_TERMIOS \
  70.   (CYGWIN_VERSION_DLL_MAKE_COMBINED (user_data->api_major, user_data->api_minor) <= \
  71.   CYGWIN_VERSION_DLL_OLD_TERMIOS)
  72.  
  73. #define CYGWIN_VERSION_DLL_MALLOC_ENV        28
  74.      /* Old APIs had getc/putc macros that conflict with new CR/LF
  75.     handling in the stdio buffers */
  76. #define CYGWIN_VERSION_OLD_STDIO_CRLF_HANDLING \
  77.   (CYGWIN_VERSION_DLL_MAKE_COMBINED (user_data->api_major, user_data->api_minor) <= \
  78.   20)
  79.  
  80. #define CYGWIN_VERSION_CHECK_FOR_S_IEXEC \
  81.   (CYGWIN_VERSION_DLL_MAKE_COMBINED (user_data->api_major, user_data->api_minor) >= \
  82.   36)
  83.  
  84. #define CYGWIN_VERSION_CHECK_FOR_OLD_O_NONBLOCK \
  85.   (CYGWIN_VERSION_DLL_MAKE_COMBINED (user_data->api_major, user_data->api_minor) <= \
  86.   28)
  87.  
  88. #define CYGWIN_VERSION_CHECK_FOR_USING_BIG_TYPES \
  89.   (CYGWIN_VERSION_DLL_MAKE_COMBINED (user_data->api_major, user_data->api_minor) >= \
  90.   79)
  91.      /* We used to use the DLL major/minor to track
  92.     non-backward-compatible interface changes to the API.  Now we
  93.     use an API major/minor number for this purpose. */
  94.  
  95.      /* API_MAJOR 0.0: Initial version.  API_MINOR changes:
  96.     1: Export cygwin32_ calls as cygwin_ as well.
  97.     2: Export j1, jn, y1, yn.
  98.     3: Export dll_noncygwin_dllcrt0.
  99.     4: New socket ioctls, revamped ifconf support.
  100.     5: Thread support/exports.
  101.     6: Change in termios handling.
  102.     7: Export scandir and alphasort.
  103.     8: Export _ctype_, _sys_errlist, _sys_nerr.
  104.     9: Mount-related changes, new cygwin_umount export.
  105.        Raw device support (tape, floppies).
  106.        10: Fast math routine support added.
  107.        11: Export seekdir, telldir.
  108.        12: Export pthread_join, pthread_detach.
  109.        13: Export math funcs gamma and friends, also _j0, _j1, etc.
  110.        14: Export snprintf and vnsprintf.
  111.        15: Export glob
  112.        16: Export cygwin_stackdump
  113.        17: Export fast math stuff
  114.        18: Stop exporting _strace_wm
  115.        19: Export fchown, lchown, lacl
  116.        20: regsub, inet_network
  117.        21: incompatible change to stdio cr/lf and buffering
  118.        22: Export cygwin_logon_user, cygwin_set_impersonation_token.
  119.        geteuid, getegid return effective uid/gid.
  120.        getuid, getgid return real uid/gid.
  121.        seteuid, setegid set only effective uid/gid.
  122.        setuid, setgid set effective and real uid/gid.
  123.        23: Export new dll_crt0 interface and cygwin_user_data for use
  124.        with crt0 startup code.
  125.        24: Export poll and _poll.
  126.        25: Export getmode and _getmode.
  127.        26: CW_GET_CYGDRIVE_PREFIXES addition to external.cc
  128.        27: CW_GETPINFO_FULL addition to external.cc
  129.        28: Accidentally bumped by cgf
  130.        29: Export hstrerror
  131.        30: CW_GET_CYGDRIVE_INFO addition to external.cc
  132.        31: Export inet_aton
  133.        32: Export getrlimit/setrlimit
  134.        33: Export setlogmask
  135.        34: Separated out mount table
  136.        35: Export drand48, erand48, jrand48, lcong48, lrand48,
  137.        mrand48, nrand48, seed48, and srand48.
  138.        36: Added _cygwin_S_IEXEC, et al
  139.        37: [f]pathconv support _PC_POSIX_PERMISSIONS and _PC_POSIX_SECURITY
  140.        38: vscanf, vscanf_r, and random pthread functions
  141.        39: asctime_r, ctime_r, gmtime_r, localtime_r
  142.        40: fchdir
  143.        41: __signgam
  144.        42: sys_errlist, sys_nerr
  145.        43: sigsetjmp, siglongjmp fixed
  146.        44: Export dirfd
  147.        45: perprocess change, gamma_r, gammaf_r, lgamma_r, lgammaf_r
  148.        46: Remove cygwin_getshared
  149.        47: Report EOTWarningZoneSize in struct mtget.
  150.        48: Export "posix" regex functions
  151.        49: Export setutent, endutent, utmpname, getutent, getutid, getutline.
  152.        50: Export fnmatch.
  153.        51: Export recvmsg, sendmsg.
  154.        52: Export strptime
  155.        53: Export strlcat, strlcpy.
  156.        54: Export __fpclassifyd, __fpclassifyf, __signbitd, __signbitf.
  157.        55: Export fcloseall, fcloseall_r.
  158.        56: Make ntsec on by default.
  159.        57: Export setgroups.
  160.        58: Export memalign, valloc, malloc_trim, malloc_usable_size, mallopt,
  161.        malloc_stats
  162.        59: getsid
  163.        60: MSG_NOSIGNAL
  164.        61: Export getc_unlocked, getchar_unlocked, putc_unlocked,
  165.        putchar_unlocked
  166.        62: Erroneously bumped
  167.        63: Export pututline
  168.        64: Export fseeko, ftello
  169.        65: Export siginterrupt
  170.        66: Export nl_langinfo
  171.        67: Export pthread_getsequence_np
  172.        68: Export netdb stuff
  173.        69: Export strtof
  174.        70: Export asprintf, _asprintf_r, vasprintf, _vasprintf_r
  175.        71: Export strerror_r
  176.        72: Export nanosleep
  177.        73: Export setreuid32, setreuid, setregid32, setregid
  178.        74: Export _strtold a64l hcreate hcreate_r hdestroy hdestroy_r hsearch
  179.           hsearch_r isblank iswalnum iswalpha iswblank iswcntrl iswctype
  180.           iswdigit iswgraph iswlower iswprint iswpunct iswspace iswupper
  181.           iswxdigit l64a mbrlen mbrtowc mbsinit mbsrtowcs mempcpy
  182.           on_exit setbuffer setlinebuf strndup strnlen tdelete tdestroy
  183.           tfind towctrans towlower towupper tsearch twalk wcrtomb wcscat
  184.           wcschr wcscpy wcscspn wcslcat wcslcpy wcsncat wcsncmp wcsncpy
  185.           wcspbrk wcsrchr wcsrtombs wcsspn wcsstr wctob wctob wctrans
  186.           wctype wmemchr wmemcmp wmemcpy wmemmove wmemset
  187.        75: Export exp2 exp2f fdim fdimf fma fmaf fmax fmaxf fmin fminf lrint
  188.           lrintf lround lroundf nearbyint nearbyintf remquo remquof
  189.           round roundf scalbln scalblnf sincos sincosf tgamma tgammaf
  190.           truncf
  191.        76: mallinfo
  192.        77: thread-safe exit/at_exit
  193.        78: Use stat and fstat rather than _stat, and _fstat.
  194.        Export btowc and trunc.
  195.        79: Export acl32 aclcheck32 aclfrommode32 aclfrompbits32 aclfromtext32
  196.           aclsort32 acltomode32 acltopbits32 acltotext32 facl32
  197.           fgetpos64 fopen64 freopen64 fseeko64 fsetpos64 ftello64
  198.           _open64 _lseek64 _fstat64 _stat64 mknod32
  199.        80: Export pthread_rwlock stuff
  200.        81: CW_CHECK_NTSEC addition to external.cc
  201.        82: Export wcscoll wcswidth wcwidth
  202.        83: Export gethostid
  203.        84: Pty open allocates invisible console.  64 bit interface
  204.        85: Export new 32/64 functions from API 0.79 only with leading
  205.        underscore.  No problems with backward compatibility since no
  206.        official release has been made so far.  This change removes
  207.        exported symbols like fopen64, which might confuse configure.
  208.        86: Export ftok
  209.        87: Export vsyslog
  210.        88: Export _getreent
  211.        89: Export __mempcpy
  212.        90: Export _fopen64
  213.        91: Export argz_add argz_add_sep argz_append argz_count argz_create
  214.        argz_create_sep argz_delete argz_extract argz_insert
  215.        argz_next argz_replace argz_stringify envz_add envz_entry
  216.        envz_get envz_merge envz_remove envz_strip
  217.        92: Export getusershell, setusershell, endusershell
  218.        93: Export daemon, forkpty, openpty, iruserok, ruserok, login_tty,
  219.        openpty, forkpty, revoke, logwtmp, updwtmp
  220.        94: Export getopt, getopt_long, optarg, opterr, optind, optopt,
  221.        optreset, __check_rhosts_file, __rcmd_errstr.
  222.        95: Export shmat, shmctl, shmdt, shmget.
  223.        96: CW_GET_ERRNO_FROM_WINERROR addition to external.cc
  224.        97: Export sem_open, sem_close, sem_timedwait, sem_getvalue.
  225.        98: Export _tmpfile64.
  226.        99: CW_GET_POSIX_SECURITY_ATTRIBUTE addition to external.cc.
  227.       100: CW_GET_SHMLBA addition to external.cc.
  228.       101: Export err, errx, verr, verrx, warn, warnx, vwarn, vwarnx.
  229.       102: CW_GET_UID_FROM_SID and CW_GET_GID_FROM_SID addition to external.cc.
  230.       103: Export getprogname, setprogname.
  231.       104: Export msgctl, msgget, msgrcv, msgsnd, semctl, semget, semop.
  232.       105: Export sigwait.
  233.       106: Export flock.
  234.       107: Export fcntl64.
  235.       108: Remove unused (hopefully) reent_data export.
  236.       109: Oh well.  Someone uses reent_data.
  237.      */
  238.  
  239.      /* Note that we forgot to bump the api for ualarm, strtoll, strtoull */
  240.  
  241. #define CYGWIN_VERSION_API_MAJOR 0
  242. #define CYGWIN_VERSION_API_MINOR 109
  243.  
  244.      /* There is also a compatibity version number associated with the
  245.     shared memory regions.  It is incremented when incompatible
  246.     changes are made to the shared memory region *or* to any named
  247.     shared mutexes, semaphores, etc.   The arbitrary starting
  248.     version was 0 (cygwin release 98r2). */
  249.  
  250. #define CYGWIN_VERSION_SHARED_DATA 3
  251.  
  252.      /* An identifier used in the names used to create shared objects.
  253.     The full names include the CYGWIN_VERSION_SHARED_DATA version
  254.     as well as this identifier. */
  255.  
  256. #define CYGWIN_VERSION_DLL_IDENTIFIER    "cygwin1"
  257.  
  258.      /* The Cygwin mount table interface in the Win32 registry also
  259.     has a version number associated with it in case that is
  260.     changed in a non-backwards compatible fashion.  Increment this
  261.     version number whenever incompatible changes in mount table
  262.     registry usage are made.
  263.  
  264.     1: Original number version.
  265.     2: New mount registry layout, system-wide mount accessibility.
  266.      */
  267.  
  268. #define CYGWIN_VERSION_MOUNT_REGISTRY 2
  269.  
  270.      /* Identifiers used in the Win32 registry. */
  271.  
  272. #define CYGWIN_INFO_CYGNUS_REGISTRY_NAME "Cygnus Solutions"
  273. #define CYGWIN_INFO_CYGWIN_REGISTRY_NAME "Cygwin"
  274. #define CYGWIN_INFO_PROGRAM_OPTIONS_NAME "Program Options"
  275. #define CYGWIN_INFO_CYGWIN_MOUNT_REGISTRY_NAME "mounts v2"
  276. #define CYGWIN_INFO_CYGDRIVE_FLAGS "cygdrive flags"
  277. #define CYGWIN_INFO_CYGDRIVE_PREFIX "cygdrive prefix"
  278. #define CYGWIN_INFO_CYGDRIVE_DEFAULT_PREFIX "/cygdrive"
  279.  
  280.      /* In addition to the above version number strings, the build
  281.     process adds some strings that may be useful in
  282.     debugging/identifying a particular Cygwin DLL:
  283.  
  284.     The mkvers.sh script at the top level produces a .cc file
  285.     which initializes a cygwin_version structure based on the
  286.     above version information and creates a string table for
  287.     grepping via "fgrep '%%%' cygwinwhatever.dll" if you are
  288.     using GNU grep.  Otherwise you may want to do a
  289.     "strings cygwinwhatever.dll | fgrep '%%%'" instead.
  290.  
  291.     This will produce output such as:
  292.  
  293.     %%% Cygwin dll_identifier: cygwin
  294.     %%% Cygwin api_major: 0
  295.     %%% Cygwin api_minor: 0
  296.     %%% Cygwin dll_major: 19
  297.     %%% Cygwin dll_minor: 6
  298.     %%% Cygwin shared_data: 1
  299.     %%% Cygwin registry: b15
  300.     %%% Cygwin build date: Wed Oct 14 16:26:51 EDT 1998
  301.     %%% Cygwin shared id: cygwinS1
  302.  
  303.     This information can also be obtained through a call to
  304.     cygwin_internal (CW_GETVERSIONINFO).
  305.      */
  306.  
  307. #define CYGWIN_VERSION_MAGIC(a, b) ((unsigned) ((((unsigned short) a) << 16) | (unsigned short) b))
  308. #define CYGWIN_VERSION_MAGIC_VERSION(a) ((unsigned) ((unsigned)a & 0xffff))
  309.