Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 1 | """Shared AIX support functions.""" |
| 2 | |
| 3 | import sys |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 4 | import sysconfig |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 5 | |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 6 | try: |
| 7 | import subprocess |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 8 | except ImportError: # pragma: no cover |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 9 | # _aix_support is used in distutils by setup.py to build C extensions, |
| 10 | # before subprocess dependencies like _posixsubprocess are available. |
| 11 | import _bootsubprocess as subprocess |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 12 | |
| 13 | |
| 14 | def _aix_tag(vrtl, bd): |
| 15 | # type: (List[int], int) -> str |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 16 | # Infer the ABI bitwidth from maxsize (assuming 64 bit as the default) |
| 17 | _sz = 32 if sys.maxsize == (2**31-1) else 64 |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 18 | # vrtl[version, release, technology_level] |
| 19 | return "aix-{:1x}{:1d}{:02d}-{:04d}-{}".format(vrtl[0], vrtl[1], vrtl[2], bd, _sz) |
| 20 | |
| 21 | |
| 22 | # extract version, release and technology level from a VRMF string |
| 23 | def _aix_vrtl(vrmf): |
| 24 | # type: (str) -> List[int] |
| 25 | v, r, tl = vrmf.split(".")[:3] |
| 26 | return [int(v[-1]), int(r), int(tl)] |
| 27 | |
| 28 | |
| 29 | def _aix_bosmp64(): |
| 30 | # type: () -> Tuple[str, int] |
| 31 | """ |
| 32 | Return a Tuple[str, int] e.g., ['7.1.4.34', 1806] |
| 33 | The fileset bos.mp64 is the AIX kernel. It's VRMF and builddate |
| 34 | reflect the current ABI levels of the runtime environment. |
| 35 | """ |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 36 | # We expect all AIX systems to have lslpp installed in this location |
| 37 | out = subprocess.check_output(["/usr/bin/lslpp", "-Lqc", "bos.mp64"]) |
| 38 | out = out.decode("utf-8") |
| 39 | out = out.strip().split(":") # type: ignore |
| 40 | # Use str() and int() to help mypy see types |
| 41 | return (str(out[2]), int(out[-1])) |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 42 | |
| 43 | |
| 44 | def aix_platform(): |
| 45 | # type: () -> str |
| 46 | """ |
| 47 | AIX filesets are identified by four decimal values: V.R.M.F. |
| 48 | V (version) and R (release) can be retreived using ``uname`` |
| 49 | Since 2007, starting with AIX 5.3 TL7, the M value has been |
| 50 | included with the fileset bos.mp64 and represents the Technology |
| 51 | Level (TL) of AIX. The F (Fix) value also increases, but is not |
| 52 | relevant for comparing releases and binary compatibility. |
| 53 | For binary compatibility the so-called builddate is needed. |
| 54 | Again, the builddate of an AIX release is associated with bos.mp64. |
| 55 | AIX ABI compatibility is described as guaranteed at: https://www.ibm.com/\ |
| 56 | support/knowledgecenter/en/ssw_aix_72/install/binary_compatability.html |
| 57 | |
| 58 | For pep425 purposes the AIX platform tag becomes: |
| 59 | "aix-{:1x}{:1d}{:02d}-{:04d}-{}".format(v, r, tl, builddate, bitsize) |
| 60 | e.g., "aix-6107-1415-32" for AIX 6.1 TL7 bd 1415, 32-bit |
| 61 | and, "aix-6107-1415-64" for AIX 6.1 TL7 bd 1415, 64-bit |
| 62 | """ |
| 63 | vrmf, bd = _aix_bosmp64() |
| 64 | return _aix_tag(_aix_vrtl(vrmf), bd) |
| 65 | |
| 66 | |
| 67 | # extract vrtl from the BUILD_GNU_TYPE as an int |
| 68 | def _aix_bgt(): |
| 69 | # type: () -> List[int] |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 70 | gnu_type = sysconfig.get_config_var("BUILD_GNU_TYPE") |
| 71 | if not gnu_type: |
| 72 | raise ValueError("BUILD_GNU_TYPE is not defined") |
| 73 | return _aix_vrtl(vrmf=gnu_type) |
Michael Felt | 39afa2d | 2019-12-15 15:17:53 +0100 | [diff] [blame] | 74 | |
| 75 | |
| 76 | def aix_buildtag(): |
| 77 | # type: () -> str |
| 78 | """ |
| 79 | Return the platform_tag of the system Python was built on. |
| 80 | """ |
Victor Stinner | c846ef0 | 2020-03-12 23:15:34 +0100 | [diff] [blame] | 81 | # AIX_BUILDDATE is defined by configure with: |
| 82 | # lslpp -Lcq bos.mp64 | awk -F: '{ print $NF }' |
| 83 | build_date = sysconfig.get_config_var("AIX_BUILDDATE") |
| 84 | try: |
| 85 | build_date = int(build_date) |
| 86 | except (ValueError, TypeError): |
| 87 | raise ValueError(f"AIX_BUILDDATE is not defined or invalid: " |
| 88 | f"{build_date!r}") |
| 89 | return _aix_tag(_aix_bgt(), build_date) |