ref: e436a529cd0ccb3e700269e5e5df5eabfaa28d64
parent: 7e619e59e4fc445f9d42e3eb919dc29c30769913
author: cinap_lenrek <[email protected]>
date: Sun Oct 29 21:55:58 EDT 2017
swap(3): document permissions and encryption behaviour, reference to memory(8)
--- a/sys/man/3/swap
+++ b/sys/man/3/swap
@@ -1,6 +1,6 @@
.TH SWAP 3
.SH NAME
-swap \- memory usage statistics and pagefile control
+swap \- memory usage statistics and swap file control
.SH SYNOPSIS
.nf
.B bind -a #¶ /dev
@@ -20,11 +20,13 @@
\fIn\fP/\fIm\fP swap
\fIa\fP/\fIn\fP/\fIm\fP kernel malloc
\fIa\fP/\fIn\fP/\fIm\fP kernel draw
+\fIa\fP/\fIn\fP/\fIm\fP kernel secret
.EE
.PP
These are total memory (bytes), system page size (bytes),
kernel memory (pages), user memory (pages), swap space (pages),
-kernel malloced data (bytes), and kernel graphics data (bytes).
+kernel malloced data (bytes), kernel graphics data (bytes)
+and kernel secret data (bytes).
The expression
.IR n / m
indicates
@@ -40,7 +42,11 @@
To turn on swapping, write to
.B swap
the textual file descriptor number of a file or device on which to swap.
+.PP
+Only the hostowner is allowed to enable swapping. The pages written to
+the swap file are transparently encrypted by the kernel using a random key.
.SH SEE ALSO
+.IR memory (8),
.IR swap (8).
.SH SOURCE
.B /sys/src/9/port/devswap.c