From: Steve Dower <steve.dower@microsoft.com>
Date: Tue, 29 May 2018 00:24:36 +0000 (-0700)
Subject: bpo-32878: Adds documentation for st_ino on Windows (GH-5764)
X-Git-Tag: v3.8.0a1~1737
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3e51a3d5927c680d5410ff11ff8d5e5bb9ffb1e7;p=thirdparty%2FPython%2Fcpython.git

bpo-32878: Adds documentation for st_ino on Windows (GH-5764)
---

diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 4b4e93106692..d5bc612f451c 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -2378,7 +2378,13 @@ features:
 
    .. attribute:: st_ino
 
-      Inode number.
+      Platform dependent, but if non-zero, uniquely identifies the
+      file for a given value of ``st_dev``. Typically:
+
+      * the inode number on Unix,
+      * the `file index
+        <https://msdn.microsoft.com/en-us/library/aa363788>`_ on
+        Windows
 
    .. attribute:: st_dev
 
@@ -2537,6 +2543,10 @@ features:
    .. versionadded:: 3.5
       Added the :attr:`st_file_attributes` member on Windows.
 
+   .. versionchanged:: 3.5
+      Windows now returns the file index as :attr:`st_ino` when
+      available.
+
    .. versionadded:: 3.7
       Added the :attr:`st_fstype` member to Solaris/derivatives.