remap#

Resize an existing mapping in place.

Σύνοψη#

remap $map, $new_size;

Ορίσματα#

  • $lvalue - a currently mapped scalar.

  • $new_size - new length in bytes. Must be greater than zero.

When it applies#

remap is Linux-specific. It wraps mremap(2) with MREMAP_MAYMOVE, so the scalar may end up pointing to a different virtual address after the call.

  • For a file-backed mapping, the underlying file must be large enough to cover $new_size, or accessing the extra pages will produce a bus fault.

  • Anonymous shared mappings cannot be remapped.

Use with caution on production data.

Διαφορές από το upstream#

Fully compatible with upstream File::Map 0.71.

Δείτε επίσης#

  • map_file - pick the right size up front if you can.

  • unmap - drop the mapping entirely instead of resizing.