internal/syscall/unix: document randomTrap

Updates #10848

Change-Id: I8353100ed01cb0e8fc19225157f5709bae388612
Reviewed-on: https://go-review.googlesource.com/20975
Reviewed-by: Rob Pike <r@golang.org>

diff --git a/src/internal/syscall/unix/getrandom_linux_386.go b/src/internal/syscall/unix/getrandom_linux_386.go
index 6e41c1c61daf13e901a91a082e2d0bc12f619867..a583896e683f1f2d1fbfe6085ec0b5482a456d8b 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_386.go
+++ b/src/internal/syscall/unix/getrandom_linux_386.go
@@ -4,4 +4,6 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
 const randomTrap uintptr = 355

diff --git a/src/internal/syscall/unix/getrandom_linux_amd64.go b/src/internal/syscall/unix/getrandom_linux_amd64.go
index 94e98d220badffa90358bc949d61d4896cc2ca15..cff0eb6f052173de78d102b710652b9ea237895a 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_amd64.go
+++ b/src/internal/syscall/unix/getrandom_linux_amd64.go
@@ -4,4 +4,6 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
 const randomTrap uintptr = 318

diff --git a/src/internal/syscall/unix/getrandom_linux_arm.go b/src/internal/syscall/unix/getrandom_linux_arm.go
index b632709e8e164b1c5180cce59a37f8483718dd57..92e2492cd03b4a9fc7debe70247710bcabaa777b 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_arm.go
+++ b/src/internal/syscall/unix/getrandom_linux_arm.go
@@ -4,4 +4,6 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
 const randomTrap uintptr = 384

diff --git a/src/internal/syscall/unix/getrandom_linux_generic.go b/src/internal/syscall/unix/getrandom_linux_generic.go
index ab3f47e13ed33fad1a22a00bbcecb7180efa42a2..8425800b6da8417cb53763f32219e701888703f6 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_generic.go
+++ b/src/internal/syscall/unix/getrandom_linux_generic.go
@@ -6,4 +6,11 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
+//
+// This file is named "generic" because at a certain point Linux
+// started standardizing on system call numbers across
+// architectures. So far this means only arm64 uses the standard
+// numbers.
 const randomTrap uintptr = 278

diff --git a/src/internal/syscall/unix/getrandom_linux_mips64x.go b/src/internal/syscall/unix/getrandom_linux_mips64x.go
index 58e1d816e7aca2f8cad85f2668e9a4cc42df5af9..b328b8f1f0e59e5fcc120da0e08455d0ef9046a1 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_mips64x.go
+++ b/src/internal/syscall/unix/getrandom_linux_mips64x.go
@@ -6,4 +6,6 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
 const randomTrap uintptr = 5313

diff --git a/src/internal/syscall/unix/getrandom_linux_ppc64x.go b/src/internal/syscall/unix/getrandom_linux_ppc64x.go
index 0e4b47392bf16c81df8a692994c702bfd3799118..9b6e9722be91f134d89a0268cdaa31b0536a40d8 100644 (file)
--- a/src/internal/syscall/unix/getrandom_linux_ppc64x.go
+++ b/src/internal/syscall/unix/getrandom_linux_ppc64x.go
@@ -6,4 +6,6 @@
 
 package unix
 
+// Linux getrandom system call number.
+// See GetRandom in getrandom_linux.go.
 const randomTrap uintptr = 359