bpo-37964: add F_GETPATH command in fcntl module

Author: vinay0410

Doc/library/fcntl.rst

@@ -33,6 +33,11 @@ descriptor.
    ``F_SEAL_*`` constants for sealing of :func:`os.memfd_create` file
    descriptors.
 
+.. versionchanged:: 3.9
+   The fcntl module now contains ``F_GETPATH`` constant, which will only be
+   available in macos, and can be used to get path of a file from corresponfing
+   file descriptor.
+
 The module defines the following functions:
 
 

Lib/test/test_fcntl.py

@@ -144,6 +144,14 @@ def test_flock_overflow(self):
         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)
+        s = '$'*len(abspath)
+        res = fcntl.fcntl(self.f.fileno(), fcntl.F_GETPATH, s)
+        self.assertEqual(abspath, res.decode('utf-8'))
+        self.f.close()
 
 def test_main():
     run_unittest(TestFcntl)

Misc/NEWS.d/next/Library/2019-08-27-21-19-28.bpo-37964.SxdnsF.rst

@@ -0,0 +1 @@
+add F_GETPATH command in fcntl module

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