File size: 1,377 Bytes
ad5f26a
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# mypy: allow-untyped-defs
"""Adds docstrings to Storage functions"""

import torch._C
from torch._C import _add_docstr as add_docstr


storage_classes = ["StorageBase"]


def add_docstr_all(method, docstr):
    for cls_name in storage_classes:
        cls = getattr(torch._C, cls_name)
        try:
            add_docstr(getattr(cls, method), docstr)
        except AttributeError:
            pass


add_docstr_all(
    "from_file",
    """

from_file(filename, shared=False, nbytes=0) -> Storage



Creates a CPU storage backed by a memory-mapped file.



If ``shared`` is ``True``, then memory is shared between all processes.

All changes are written to the file. If ``shared`` is ``False``, then the changes on

the storage do not affect the file.



``nbytes`` is the number of bytes of storage. If ``shared`` is ``False``,

then the file must contain at least ``nbytes`` bytes. If ``shared`` is

``True`` the file will be created if needed. (Note that for ``UntypedStorage``

this argument differs from that of ``TypedStorage.from_file``)



Args:

    filename (str): file name to map

    shared (bool): whether to share memory (whether ``MAP_SHARED`` or ``MAP_PRIVATE`` is passed to the

                    underlying `mmap(2) call <https://man7.org/linux/man-pages/man2/mmap.2.html>`_)

    nbytes (int): number of bytes of storage

""",
)