diff options
| -rw-r--r-- | Doc/library/mmap.rst | 24 | ||||
| -rw-r--r-- | Misc/NEWS.d/next/Library/2017-10-23.bpo-31854.fh8334f.rst | 1 | ||||
| -rw-r--r-- | Modules/mmapmodule.c | 1 |
3 files changed, 16 insertions, 10 deletions
diff --git a/Doc/library/mmap.rst b/Doc/library/mmap.rst index f46bf66..184119d 100644 --- a/Doc/library/mmap.rst +++ b/Doc/library/mmap.rst @@ -29,16 +29,20 @@ still needs to be closed when done). mapping. For both the Unix and Windows versions of the constructor, *access* may be -specified as an optional keyword parameter. *access* accepts one of three -values: :const:`ACCESS_READ`, :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY` -to specify read-only, write-through or copy-on-write memory respectively. -*access* can be used on both Unix and Windows. If *access* is not specified, -Windows mmap returns a write-through mapping. The initial memory values for -all three access types are taken from the specified file. Assignment to an -:const:`ACCESS_READ` memory map raises a :exc:`TypeError` exception. -Assignment to an :const:`ACCESS_WRITE` memory map affects both memory and the -underlying file. Assignment to an :const:`ACCESS_COPY` memory map affects -memory but does not update the underlying file. +specified as an optional keyword parameter. *access* accepts one of four +values: :const:`ACCESS_READ`, :const:`ACCESS_WRITE`, or :const:`ACCESS_COPY` to +specify read-only, write-through or copy-on-write memory respectively, or +:const:`ACCESS_DEFAULT` to defer to *prot*. *access* can be used on both Unix +and Windows. If *access* is not specified, Windows mmap returns a +write-through mapping. The initial memory values for all three access types +are taken from the specified file. Assignment to an :const:`ACCESS_READ` +memory map raises a :exc:`TypeError` exception. Assignment to an +:const:`ACCESS_WRITE` memory map affects both memory and the underlying file. +Assignment to an :const:`ACCESS_COPY` memory map affects memory but does not +update the underlying file. + +.. versionchanged:: 3.7 + Added :const:`ACCESS_DEFAULT` constant. To map anonymous memory, -1 should be passed as the fileno along with the length. diff --git a/Misc/NEWS.d/next/Library/2017-10-23.bpo-31854.fh8334f.rst b/Misc/NEWS.d/next/Library/2017-10-23.bpo-31854.fh8334f.rst new file mode 100644 index 0000000..6313148 --- /dev/null +++ b/Misc/NEWS.d/next/Library/2017-10-23.bpo-31854.fh8334f.rst @@ -0,0 +1 @@ +Add ``mmap.ACCESS_DEFAULT`` constant. diff --git a/Modules/mmapmodule.c b/Modules/mmapmodule.c index 49214a1..ea7baf4 100644 --- a/Modules/mmapmodule.c +++ b/Modules/mmapmodule.c @@ -1466,6 +1466,7 @@ PyInit_mmap(void) setint(dict, "ALLOCATIONGRANULARITY", (long)my_getallocationgranularity()); + setint(dict, "ACCESS_DEFAULT", ACCESS_DEFAULT); setint(dict, "ACCESS_READ", ACCESS_READ); setint(dict, "ACCESS_WRITE", ACCESS_WRITE); setint(dict, "ACCESS_COPY", ACCESS_COPY); |