1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright 2015 Joyent, Inc.
13.\"
14.Dd November 27, 2023
15.Dt PROC_CONTENT2STR 3PROC
16.Os
17.Sh NAME
18.Nm proc_content2str ,
19.Nm proc_str2content
20.Nd convert a string to and from a core_content_t
21.Sh LIBRARY
22.Lb libproc
23.Sh SYNOPSIS
24.In libproc.h
25.Ft int
26.Fo proc_content2str
27.Fa "core_content_t content"
28.Fa "char *buf"
29.Fa "size_t size"
30.Fc
31.Ft int
32.Fo proc_str2content
33.Fa "const char *str"
34.Fa "core_content_t *cp"
35.Fc
36.Sh DESCRIPTION
37The
38.Fn proc_content2str
39function converts the contents of a process (whether active or a core
40file) from
41.Fa content
42into a string and writes up to
43.Fa size
44characters, including the null-terminator, into
45.Fa buf .
46.Pp
47A content string will be a series of one or more tokens concatenated
48together with the
49.Sy +
50or
51.Sy -
52characters, indicating that the subsequent token should be added or
53subtracted from the previous ones.
54The full list of tokens and constants is available in the
55.Sy core_content_t
56portion of the
57.Sy TYPES
58section in
59.Xr libproc 3LIB .
60.Pp
61The
62.Fn proc_str2content
63function takes the character string
64.Fa str
65and based on the format described in the previous paragraph, converts it
66back into a
67.Vt core_content_t
68which is placed into
69.Fa cp .
70.Sh RETURN VALUES
71Upon successful completion, the
72.Fn proc_content2str
73function will return the number of characters written into
74.Fa buf ,
75excluding the terminating null character.
76.Pp
77Upon successful completion, the
78.Fn proc_str2content
79function will return
80.Sy 0 .
81Otherwise,
82.Sy -1
83will be returned to indicate an unknown string.
84.Sh INTERFACE STABILITY
85.Sy Uncommitted
86.Sh MT-LEVEL
87.Sy MT-Safe
88.Sh SEE ALSO
89.Xr libproc 3LIB ,
90.Xr proc 5 ,
91.Xr coreadm 8
92