diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst index 2db9674952d..6a66f5b6648 100644 --- a/Doc/library/fcntl.rst +++ b/Doc/library/fcntl.rst @@ -33,6 +33,10 @@ descriptor. ``F_SEAL_*`` constants for sealing of :func:`os.memfd_create` file descriptors. +.. versionchanged:: 3.9 + On macOS, the fcntl module exposes the ``F_GETPATH`` constant, which obtains + the path of a file from a file descriptor. + The module defines the following functions: diff --git a/Lib/test/test_fcntl.py b/Lib/test/test_fcntl.py index 5d4abe388f7..38097dbdfb9 100644 --- a/Lib/test/test_fcntl.py +++ b/Lib/test/test_fcntl.py @@ -144,6 +144,12 @@ class TestFcntl(unittest.TestCase): self.assertRaises(OverflowError, fcntl.flock, _testcapi.INT_MAX+1, fcntl.LOCK_SH) + @unittest.skipIf(sys.platform != 'darwin', "F_GETPATH is only available on macos") + def test_fcntl_f_getpath(self): + self.f = open(TESTFN, 'wb') + abspath = os.path.abspath(TESTFN) + res = fcntl.fcntl(self.f.fileno(), fcntl.F_GETPATH, bytes(len(abspath))) + self.assertEqual(abspath, res.decode('utf-8')) def test_main(): run_unittest(TestFcntl) diff --git a/Misc/NEWS.d/next/Library/2019-08-27-21-19-28.bpo-37964.SxdnsF.rst b/Misc/NEWS.d/next/Library/2019-08-27-21-19-28.bpo-37964.SxdnsF.rst new file mode 100644 index 00000000000..c25e64329c4 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2019-08-27-21-19-28.bpo-37964.SxdnsF.rst @@ -0,0 +1 @@ +Add ``F_GETPATH`` command to :mod:`fcntl`. diff --git a/Modules/fcntlmodule.c b/Modules/fcntlmodule.c index 0fbf7876c3e..cfa12256840 100644 --- a/Modules/fcntlmodule.c +++ b/Modules/fcntlmodule.c @@ -501,6 +501,9 @@ all_ins(PyObject* m) #ifdef F_SETOWN if (PyModule_AddIntMacro(m, F_SETOWN)) return -1; #endif +#ifdef F_GETPATH + if (PyModule_AddIntMacro(m, F_GETPATH)) return -1; +#endif #ifdef F_GETSIG if (PyModule_AddIntMacro(m, F_GETSIG)) return -1; #endif