36.2.1 File Operations

locking( fd, mode, nbytes): Lock part of a file based on file descriptor fd from the C runtime. Raises IOError on failure. The locked region of the file extends from the current file position for nbytes bytes, and may continue beyond the end of the file. mode must be one of the LK_* constants listed below. Multiple regions in a file may be locked at the same time, but may not overlap. Adjacent regions are not merged; they must be unlocked individually.

LK_LOCK
LK_RLCK: Locks the specified bytes. If the bytes cannot be locked, the program immediately tries again after 1 second. If, after 10 attempts, the bytes cannot be locked, IOError is raised.

LK_NBLCK
LK_NBRLCK: Locks the specified bytes. If the bytes cannot be locked, IOError is raised.

LK_UNLCK: Unlocks the specified bytes, which must have been previously locked.

setmode( fd, flags): Set the line-end translation mode for the file descriptor fd. To set it to text mode, flags should be os.O_TEXT; for binary, it should be os.O_BINARY.

open_osfhandle( handle, flags): Create a C runtime file descriptor from the file handle handle. The flags parameter should be a bit-wise OR of os.O_APPEND, os.O_RDONLY, and os.O_TEXT. The returned file descriptor may be used as a parameter to os.fdopen() to create a file object.

get_osfhandle( fd): Return the file handle for the file descriptor fd. Raises IOError if fd is not recognized.

See About this document... for information on suggesting changes.