Changeset 186

Timestamp:

2002-04-03 22:05:59 (7 years ago)

Author:

schwa

Message:

Documented the problem with (l)stat and RootDirError.

Files:

• trunk/ftputil.txt (modified) (5 diffs)

trunk/ftputil.txt

@@ -48 +48 @@
-            ParserError(FTPOSError)
-        FTPIOError(FTPError)
+        RootDirError(FTPError)
-
-FTPError is the root of the exception hierarchy of the module.
@@ -126 +127 @@
-codes aren't the same.)
-
+RootDirError is a special case. Due to the implementation of the
+lstat method it is not possible to do a stat on the root directory /.
+If you know _any_ way to do it, please let me know. :-)
+
-----------------------------------------------------------------------
-FTPHost OBJECTS
@@ -260 +265 @@
-    - Links can only be recognized on servers that provide this
-      information in the DIR output.
-
+
-    - Items that can't be determined at all, are set to None.
+
+    - There's a special problem with stat'ing the root directory. In
+      this case, a RootDirError is raised. This has to do with the
+      algorithm used by (l)stat and a know of no one which solves
+      this problem.
-
-    Currently, ftputil recognizes the MS Robin FTP server. Otherwise,
@@ -333 +343 @@
-  below-mentioned email address.
-
+- Due to the implementation of lstat it can not return a sensible
+  value for the root directory /. If you know an implementation that
+  can do this, please let me know. The root directory is handled
+  appropriately in FTPHost.path.exists/isfile/isdir/islink, though.
+
-- Depending on local time and/or daylight saving time settings
-  different local hosts may interpret the modification times in the
@@ -360 +375 @@
-ftputil.py
-    is the main module file.
-
+
-UserTuple.py
-    may be used as the base class for _Stat. If you have at least