Print this page
8158 Want named threads API
9857 proc manpages should have LIBRARY section
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man3proc/Pwrite.3proc.man.txt
+++ new/usr/src/man/man3proc/Pwrite.3proc.man.txt
1 1 PWRITE(3PROC) Process Control Library Functions PWRITE(3PROC)
2 2
3 3 NAME
4 4 Pwrite - write data to the address space of a process
5 5
6 -SYNOPSIS
6 +LIBRARY
7 7 Process Control Library (libproc, -lproc)
8 +
9 +SYNOPSIS
8 10 #include <libproc.h>
9 11
10 12 ssize_t
11 13 Pwrite(struct ps_prochandle *P, const void *buf, size_t nbyte,
12 14 uintptr_t address);
13 15
14 16 DESCRIPTION
15 17 The Pwrite() function writes data from buf to the process handle P
16 18 starting at the address address. It writes at most nbyte of data. The
17 19 Pwrite() function is logically analogous to the pwrite(2) function.
18 20
19 21 For live processes, this function is equivalent to writing to the /proc
20 22 file system as file for the process. For core files, it writes to the
21 23 logical address space of what was once the process and not the
22 24 corresponding offset in the on-disk file. ELF objects grabbed through
23 25 Pgrab_file(3PROC) do not support being written to.
24 26
25 27 The Pwrite() function cannot be used to extend the size of a mapping;
26 28 writing to an unmapped region generates an error.
27 29
28 30 RETURN VALUES
29 31 Upon successful completion, the Pwrite() function returns the number of
30 32 bytes successfully written to P. This number is never greater than
31 33 nbyte. Otherwise, it returns -1 and errno is set to indicate an error.
32 34 For the full list of errors see the DIAGNOSTICS section in proc(4) and
33 35 the ERRORS section in pwrite(2).
34 36
35 37 In addition, the Pwrite() function will fail if:
36 38
37 39 EIO P refers to an ELF object and not a core file or
38 40 active process.
39 41
40 42 INTERFACE STABILITY
41 43 Uncommitted
42 44
43 45 MT-LEVEL
44 46 See LOCKING in libproc(3LIB).
45 47
46 48 SEE ALSO
47 49 pwrite(2), libproc(3LIB), proc(4)
48 50
49 51 illumos May 11, 2016 illumos
↓ open down ↓ |
32 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX