|
| 1 | +"""Shared AIX support functions.""" |
| 2 | + |
| 3 | +import sys |
| 4 | +import sysconfig |
| 5 | + |
| 6 | + |
| 7 | +# Taken from _osx_support _read_output function |
| 8 | +def _read_cmd_output(commandstring, capture_stderr=False): |
| 9 | + """Output from successful command execution or None""" |
| 10 | + # Similar to os.popen(commandstring, "r").read(), |
| 11 | + # but without actually using os.popen because that |
| 12 | + # function is not usable during python bootstrap. |
| 13 | + import os |
| 14 | + import contextlib |
| 15 | + fp = open("/tmp/_aix_support.%s"%( |
| 16 | + os.getpid(),), "w+b") |
| 17 | + |
| 18 | + with contextlib.closing(fp) as fp: |
| 19 | + if capture_stderr: |
| 20 | + cmd = "%s >'%s' 2>&1" % (commandstring, fp.name) |
| 21 | + else: |
| 22 | + cmd = "%s 2>/dev/null >'%s'" % (commandstring, fp.name) |
| 23 | + return fp.read() if not os.system(cmd) else None |
| 24 | + |
| 25 | + |
| 26 | +def _aix_tag(vrtl, bd): |
| 27 | + # type: (List[int], int) -> str |
| 28 | + # Infer the ABI bitwidth from maxsize (assuming 64 bit as the default) |
| 29 | + _sz = 32 if sys.maxsize == (2**31-1) else 64 |
| 30 | + _bd = bd if bd != 0 else 9988 |
| 31 | + # vrtl[version, release, technology_level] |
| 32 | + return "aix-{:1x}{:1d}{:02d}-{:04d}-{}".format(vrtl[0], vrtl[1], vrtl[2], _bd, _sz) |
| 33 | + |
| 34 | + |
| 35 | +# extract version, release and technology level from a VRMF string |
| 36 | +def _aix_vrtl(vrmf): |
| 37 | + # type: (str) -> List[int] |
| 38 | + v, r, tl = vrmf.split(".")[:3] |
| 39 | + return [int(v[-1]), int(r), int(tl)] |
| 40 | + |
| 41 | + |
| 42 | +def _aix_bos_rte(): |
| 43 | + # type: () -> Tuple[str, int] |
| 44 | + """ |
| 45 | + Return a Tuple[str, int] e.g., ['7.1.4.34', 1806] |
| 46 | + The fileset bos.rte represents the current AIX run-time level. It's VRMF and |
| 47 | + builddate reflect the current ABI levels of the runtime environment. |
| 48 | + If no builddate is found give a value that will satisfy pep425 related queries |
| 49 | + """ |
| 50 | + # All AIX systems to have lslpp installed in this location |
| 51 | + # subprocess may not be available during python bootstrap |
| 52 | + try: |
| 53 | + import subprocess |
| 54 | + out = subprocess.check_output(["/usr/bin/lslpp", "-Lqc", "bos.rte"]) |
| 55 | + except ImportError: |
| 56 | + out = _read_cmd_output("/usr/bin/lslpp -Lqc bos.rte") |
| 57 | + out = out.decode("utf-8") |
| 58 | + out = out.strip().split(":") # type: ignore |
| 59 | + _bd = int(out[-1]) if out[-1] != '' else 9988 |
| 60 | + return (str(out[2]), _bd) |
| 61 | + |
| 62 | + |
| 63 | +def aix_platform(): |
| 64 | + # type: () -> str |
| 65 | + """ |
| 66 | + AIX filesets are identified by four decimal values: V.R.M.F. |
| 67 | + V (version) and R (release) can be retrieved using ``uname`` |
| 68 | + Since 2007, starting with AIX 5.3 TL7, the M value has been |
| 69 | + included with the fileset bos.rte and represents the Technology |
| 70 | + Level (TL) of AIX. The F (Fix) value also increases, but is not |
| 71 | + relevant for comparing releases and binary compatibility. |
| 72 | + For binary compatibility the so-called builddate is needed. |
| 73 | + Again, the builddate of an AIX release is associated with bos.rte. |
| 74 | + AIX ABI compatibility is described as guaranteed at: https://www.ibm.com/\ |
| 75 | + support/knowledgecenter/en/ssw_aix_72/install/binary_compatability.html |
| 76 | +
|
| 77 | + For pep425 purposes the AIX platform tag becomes: |
| 78 | + "aix-{:1x}{:1d}{:02d}-{:04d}-{}".format(v, r, tl, builddate, bitsize) |
| 79 | + e.g., "aix-6107-1415-32" for AIX 6.1 TL7 bd 1415, 32-bit |
| 80 | + and, "aix-6107-1415-64" for AIX 6.1 TL7 bd 1415, 64-bit |
| 81 | + """ |
| 82 | + vrmf, bd = _aix_bos_rte() |
| 83 | + return _aix_tag(_aix_vrtl(vrmf), bd) |
| 84 | + |
| 85 | + |
| 86 | +# extract vrtl from the BUILD_GNU_TYPE as an int |
| 87 | +def _aix_bgt(): |
| 88 | + # type: () -> List[int] |
| 89 | + gnu_type = sysconfig.get_config_var("BUILD_GNU_TYPE") |
| 90 | + if not gnu_type: |
| 91 | + raise ValueError("BUILD_GNU_TYPE is not defined") |
| 92 | + return _aix_vrtl(vrmf=gnu_type) |
| 93 | + |
| 94 | + |
| 95 | +def aix_buildtag(): |
| 96 | + # type: () -> str |
| 97 | + """ |
| 98 | + Return the platform_tag of the system Python was built on. |
| 99 | + """ |
| 100 | + # AIX_BUILDDATE is defined by configure with: |
| 101 | + # lslpp -Lcq bos.rte | awk -F: '{ print $NF }' |
| 102 | + build_date = sysconfig.get_config_var("AIX_BUILDDATE") |
| 103 | + try: |
| 104 | + build_date = int(build_date) |
| 105 | + except (ValueError, TypeError): |
| 106 | + raise ValueError(f"AIX_BUILDDATE is not defined or invalid: " |
| 107 | + f"{build_date!r}") |
| 108 | + return _aix_tag(_aix_bgt(), build_date) |
0 commit comments