winsup/cygwin/include/cygwin/version.h

   1 /* version.h -- Cygwin version numbers and accompanying documentation.
   2
   3    Copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 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 13
  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       110: Export clock_gettime, sigwaitinfo, timer_create, timer_delete,
 238            timer_settime
 239       111: Export sigqueue, sighold.
 240       112: Redefine some mtget fields.
 241       113: Again redefine some mtget fields.  Use mt_fileno and mt_blkno as
 242            on Linux.
 243       114: Export rand_r, ttyname_r.
 244       115: Export flockfile, ftrylockfile, funlockfile, getgrgid_r, getgrnam_r,
 245            getlogin_r.
 246       116: Export atoll.
 247       117: Export utmpx functions, Return utmp * from pututent.
 248       118: Export getpriority, setpriority.
 249      */
 250
 251      /* Note that we forgot to bump the api for ualarm, strtoll, strtoull */
 252
 253 #define CYGWIN_VERSION_API_MAJOR 0
 254 #define CYGWIN_VERSION_API_MINOR 118
 255
 256      /* There is also a compatibity version number associated with the
 257         shared memory regions.  It is incremented when incompatible
 258         changes are made to the shared memory region *or* to any named
 259         shared mutexes, semaphores, etc.   The arbitrary starting
 260         version was 0 (cygwin release 98r2).
 261         Bump to 4 since this hasn't been rigorously updated in a
 262         while.  */
 263
 264 #define CYGWIN_VERSION_SHARED_DATA 4
 265
 266      /* An identifier used in the names used to create shared objects.
 267         The full names include the CYGWIN_VERSION_SHARED_DATA version
 268         as well as this identifier. */
 269
 270 #define CYGWIN_VERSION_DLL_IDENTIFIER   "cygwin1"
 271
 272      /* The Cygwin mount table interface in the Win32 registry also
 273         has a version number associated with it in case that is
 274         changed in a non-backwards compatible fashion.  Increment this
 275         version number whenever incompatible changes in mount table
 276         registry usage are made.
 277
 278         1: Original number version.
 279         2: New mount registry layout, system-wide mount accessibility.
 280      */
 281
 282 #define CYGWIN_VERSION_MOUNT_REGISTRY 2
 283
 284      /* Identifiers used in the Win32 registry. */
 285
 286 #define CYGWIN_INFO_CYGNUS_REGISTRY_NAME "Cygnus Solutions"
 287 #define CYGWIN_INFO_CYGWIN_REGISTRY_NAME "Cygwin"
 288 #define CYGWIN_INFO_PROGRAM_OPTIONS_NAME "Program Options"
 289 #define CYGWIN_INFO_CYGWIN_MOUNT_REGISTRY_NAME "mounts v2"
 290 #define CYGWIN_INFO_CYGDRIVE_FLAGS "cygdrive flags"
 291 #define CYGWIN_INFO_CYGDRIVE_PREFIX "cygdrive prefix"
 292 #define CYGWIN_INFO_CYGDRIVE_DEFAULT_PREFIX "/cygdrive"
 293
 294      /* In addition to the above version number strings, the build
 295         process adds some strings that may be useful in
 296         debugging/identifying a particular Cygwin DLL:
 297
 298         The mkvers.sh script at the top level produces a .cc file
 299         which initializes a cygwin_version structure based on the
 300         above version information and creates a string table for
 301         grepping via "fgrep '%%%' cygwinwhatever.dll" if you are
 302         using GNU grep.  Otherwise you may want to do a
 303         "strings cygwinwhatever.dll | fgrep '%%%'" instead.
 304
 305         This will produce output such as:
 306
 307         %%% Cygwin dll_identifier: cygwin
 308         %%% Cygwin api_major: 0
 309         %%% Cygwin api_minor: 0
 310         %%% Cygwin dll_major: 19
 311         %%% Cygwin dll_minor: 6
 312         %%% Cygwin shared_data: 1
 313         %%% Cygwin registry: b15
 314         %%% Cygwin build date: Wed Oct 14 16:26:51 EDT 1998
 315         %%% Cygwin shared id: cygwinS1
 316
 317         This information can also be obtained through a call to
 318         cygwin_internal (CW_GETVERSIONINFO).
 319      */
 320
 321 #define CYGWIN_VERSION_MAGIC(a, b) ((unsigned) ((((unsigned short) a) << 16) | (unsigned short) b))
 322 #define CYGWIN_VERSION_MAGIC_VERSION(a) ((unsigned) ((unsigned)a & 0xffff))