Clarify the behavior of the @machine and @machine_arch magic links

relative to uname output when running in emulations: the magic links
are *not* affected even though uname output changes.

(This means @machine magic links can be used for e.g. amd64 vs. i386
device nodes. There's also an @emul magic link for emulation.)

Noted by apb.
This commit is contained in:
dholland 2014-01-09 18:55:41 +00:00
parent 9a75aee207
commit b510fd7487
1 changed files with 16 additions and 10 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: symlink.7,v 1.21 2011/06/02 09:02:39 jruoho Exp $ .\" $NetBSD: symlink.7,v 1.22 2014/01/09 18:55:41 dholland Exp $
.\" .\"
.\" Copyright (c) 1992, 1993, 1994 .\" Copyright (c) 1992, 1993, 1994
.\" The Regents of the University of California. All rights reserved. .\" The Regents of the University of California. All rights reserved.
@ -29,7 +29,7 @@
.\" .\"
.\" @(#)symlink.7 8.3 (Berkeley) 3/31/94 .\" @(#)symlink.7 8.3 (Berkeley) 3/31/94
.\" .\"
.Dd June 2, 2011 .Dd January 9, 2014
.Dt SYMLINK 7 .Dt SYMLINK 7
.Os .Os
.Sh NAME .Sh NAME
@ -513,25 +513,31 @@ For example
.It @machine .It @machine
Expands to the value of Expands to the value of
.Li MACHINE .Li MACHINE
for the system for the system.
.Po For native binaries, this is
equivalent to the output of equivalent to the output of
.Dq uname -m .Dq uname -m
or or
.Xr sysctl 3 .Xr sysctl 3
.Dq hw.machine .Dq hw.machine .
.Pc . .Po
For non-native binaries, the values returned by uname and sysctl
typically vary to match the emulation environment.
.Pc
.It @machine_arch .It @machine_arch
Expands to the value of Expands to the value of
.Li MACHINE_ARCH .Li MACHINE_ARCH
for the system for the system.
.Po For native binaries, this is
equivalent to the output of equivalent to the output of
.Dq uname -p .Dq uname -p
or or
.Xr sysctl 3 .Xr sysctl 3
.Dq hw.machine_arch .Dq hw.machine_arch .
.Pc . .Po
For non-native binaries, the values returned by uname and sysctl
typically vary to match the emulation environment.
.Pc
.It @osrelease .It @osrelease
Expands to the operating system release of the running kernel Expands to the operating system release of the running kernel
.Po .Po