Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
91a90c86
Commit
91a90c86
authored
Jun 06, 2004
by
Tim Peters
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
SF 964876 mapping a 0 length file
Document that it can't be done on Windows.
parent
675a9930
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
10 additions
and
8 deletions
+10
-8
Doc/lib/libmmap.tex
Doc/lib/libmmap.tex
+10
-8
No files found.
Doc/lib/libmmap.tex
View file @
91a90c86
...
...
@@ -42,10 +42,12 @@ the underlying file.
\begin{funcdesc}
{
mmap
}{
fileno, length
\optional
{
, tagname
\optional
{
, access
}}}
\strong
{
(Windows version)
}
Maps
\var
{
length
}
bytes from the file
specified by the file handle
\var
{
fileno
}
, and returns a mmap
object. If
\var
{
length
}
is
\code
{
0
}
, the maximum length of the map
will be the current size of the file when
\function
{
mmap()
}
is
called.
object. If
\var
{
length
}
is larger than the current size of the file,
the file is extended to contain
\var
{
length
}
bytes. If
\var
{
length
}
is
\code
{
0
}
, the maximum length of the map is the current size
of the file, except that if the file is empty Windows raises an
exception (you cannot create an empty mapping on Windows).
\var
{
tagname
}
, if specified and not
\code
{
None
}
, is a string giving
a tag name for the mapping. Windows allows you to have many
different mappings against the same file. If you specify the name
...
...
@@ -61,19 +63,19 @@ the underlying file.
\strong
{
(
\UNIX
{}
version)
}
Maps
\var
{
length
}
bytes from the file
specified by the file descriptor
\var
{
fileno
}
, and returns a mmap
object.
\var
{
flags
}
specifies the nature of the mapping.
\constant
{
MAP
_
PRIVATE
}
creates a private copy-on-write mapping, so
changes to the contents of the mmap object will be private to this
process, and
\constant
{
MAP
_
SHARED
}
creates a mapping that's shared
with all other processes mapping the same areas of the file. The
default value is
\constant
{
MAP
_
SHARED
}
.
\var
{
prot
}
, if specified, gives the desired memory protection; the
two most useful values are
\constant
{
PROT
_
READ
}
and
\constant
{
PROT
_
WRITE
}
, to specify that the pages may be read or
written.
\var
{
prot
}
defaults to
\constant
{
PROT
_
READ | PROT
_
WRITE
}
.
\var
{
access
}
may be specified in lieu of
\var
{
flags
}
and
\var
{
prot
}
as an optional keyword parameter. It is an error to specify both
\var
{
flags
}
,
\var
{
prot
}
and
\var
{
access
}
. See the description of
...
...
@@ -123,7 +125,7 @@ Memory-mapped file objects support the following methods:
\end{methoddesc}
\begin{methoddesc}
{
readline
}{}
Returns a single line, starting at the current file position and up to
Returns a single line, starting at the current file position and up to
the next newline.
\end{methoddesc}
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment