summaryrefslogtreecommitdiff
path: root/sys
diff options
context:
space:
mode:
authorcinap_lenrek <cinap_lenrek@felloff.net>2017-10-30 01:55:58 +0100
committercinap_lenrek <cinap_lenrek@felloff.net>2017-10-30 01:55:58 +0100
commite436a529cd0ccb3e700269e5e5df5eabfaa28d64 (patch)
tree6f62687a51f9cd5a47bb05854e008fc86a69e0f3 /sys
parent7e619e59e4fc445f9d42e3eb919dc29c30769913 (diff)
swap(3): document permissions and encryption behaviour, reference to memory(8)
Diffstat (limited to 'sys')
-rw-r--r--sys/man/3/swap10
1 files changed, 8 insertions, 2 deletions
diff --git a/sys/man/3/swap b/sys/man/3/swap
index 09ffbdb53..905516223 100644
--- 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 @@ device holds a text block giving memory usage statistics:
\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 @@ These numbers are not blank padded.
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