annotate vendor/golang.org/x/sys/unix/sysvshm_unix.go @ 66:787b5ee0289d draft

Use vendored modules Signed-off-by: Izuru Yakumo <yakumo.izuru@chaotic.ninja>
author yakumo.izuru
date Sun, 23 Jul 2023 13:18:53 +0000
parents
children 4b79810863f6
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 2021 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 //go:build (darwin && !ios) || linux
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
6 // +build darwin,!ios linux
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
7
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
8 package unix
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
9
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
10 import (
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
11 "unsafe"
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
12
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
13 "golang.org/x/sys/internal/unsafeheader"
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
14 )
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
15
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
16 // SysvShmAttach attaches the Sysv shared memory segment associated with the
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
17 // shared memory identifier id.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
18 func SysvShmAttach(id int, addr uintptr, flag int) ([]byte, error) {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
19 addr, errno := shmat(id, addr, flag)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
20 if errno != nil {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
21 return nil, errno
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
22 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
23
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
24 // Retrieve the size of the shared memory to enable slice creation
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
25 var info SysvShmDesc
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
26
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
27 _, err := SysvShmCtl(id, IPC_STAT, &info)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
28 if err != nil {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
29 // release the shared memory if we can't find the size
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
30
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
31 // ignoring error from shmdt as there's nothing sensible to return here
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
32 shmdt(addr)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
33 return nil, err
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
34 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
35
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
36 // Use unsafe to convert addr into a []byte.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
37 // TODO: convert to unsafe.Slice once we can assume Go 1.17
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
38 var b []byte
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
39 hdr := (*unsafeheader.Slice)(unsafe.Pointer(&b))
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
40 hdr.Data = unsafe.Pointer(addr)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
41 hdr.Cap = int(info.Segsz)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
42 hdr.Len = int(info.Segsz)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
43 return b, nil
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
44 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
45
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
46 // SysvShmDetach unmaps the shared memory slice returned from SysvShmAttach.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
47 //
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
48 // It is not safe to use the slice after calling this function.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
49 func SysvShmDetach(data []byte) error {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
50 if len(data) == 0 {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
51 return EINVAL
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
52 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
53
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
54 return shmdt(uintptr(unsafe.Pointer(&data[0])))
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
55 }
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
56
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
57 // SysvShmGet returns the Sysv shared memory identifier associated with key.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
58 // If the IPC_CREAT flag is specified a new segment is created.
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
59 func SysvShmGet(key, size, flag int) (id int, err error) {
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
60 return shmget(key, size, flag)
787b5ee0289d Use vendored modules
yakumo.izuru
parents:
diff changeset
61 }