annotate vendor/golang.org/x/sys/unix/dev_linux.go @ 68:4b79810863f6 draft

Ready to release 0.6.0 Signed-off-by: Izuru Yakumo <yakumo.izuru@chaotic.ninja>
author yakumo.izuru
date Wed, 13 Sep 2023 10:49:50 +0000
parents 787b5ee0289d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
66
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
1 // Copyright 2017 The Go Authors. All rights reserved.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
2 // Use of this source code is governed by a BSD-style
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
3 // license that can be found in the LICENSE file.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
4
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
5 // Functions to access/create device major and minor numbers matching the
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
6 // encoding used by the Linux kernel and glibc.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
7 //
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
8 // The information below is extracted and adapted from bits/sysmacros.h in the
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
9 // glibc sources:
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
10 //
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
11 // dev_t in glibc is 64-bit, with 32-bit major and minor numbers. glibc's
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
12 // default encoding is MMMM Mmmm mmmM MMmm, where M is a hex digit of the major
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
13 // number and m is a hex digit of the minor number. This is backward compatible
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
14 // with legacy systems where dev_t is 16 bits wide, encoded as MMmm. It is also
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
15 // backward compatible with the Linux kernel, which for some architectures uses
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
16 // 32-bit dev_t, encoded as mmmM MMmm.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
17
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
18 package unix
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
19
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
20 // Major returns the major component of a Linux device number.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
21 func Major(dev uint64) uint32 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
22 major := uint32((dev & 0x00000000000fff00) >> 8)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
23 major |= uint32((dev & 0xfffff00000000000) >> 32)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
24 return major
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
25 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
26
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
27 // Minor returns the minor component of a Linux device number.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
28 func Minor(dev uint64) uint32 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
29 minor := uint32((dev & 0x00000000000000ff) >> 0)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
30 minor |= uint32((dev & 0x00000ffffff00000) >> 12)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
31 return minor
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
32 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
33
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
34 // Mkdev returns a Linux device number generated from the given major and minor
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
35 // components.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
36 func Mkdev(major, minor uint32) uint64 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
37 dev := (uint64(major) & 0x00000fff) << 8
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
38 dev |= (uint64(major) & 0xfffff000) << 32
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
39 dev |= (uint64(minor) & 0x000000ff) << 0
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
40 dev |= (uint64(minor) & 0xffffff00) << 12
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
41 return dev
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
42 }