1conmon(8)                   System Manager's Manual                  conmon(8)
2
3
4

NAME

6       conmon - container monitor utility
7
8
9

SYNOPSIS

11       conmon [options]
12
13
14

DESCRIPTION

16       conmon  is a command-line program for monitoring and managing the life‐
17       cycle of Linux containers that follow  the  Open  Container  Initiative
18       (OCI) format.
19
20
21

APPLICATION OPTIONS

23       --api-version Conmon API version to use.
24
25
26       -b, --bundle Location of the OCI Bundle path.
27
28
29       -c, --cid Identification of Container.
30
31
32       --exec-attach Attach to an exec session.
33
34
35       -e, --exec Exec a command into a running container.
36
37
38       --exec-process-spec Path to the process spec for execution.
39
40
41       --exit-command Path to the program to execute when the container termi‐
42       nates its execution.
43
44
45       --exit-command-arg Additional arguments to pass to  the  exit  command.
46       Can be specified multiple time.
47
48
49       --exit-delay Delay before invoking the exit command (in seconds).
50
51
52       --exit-dir Path to the directory where exit files are written.
53
54
55       -h, --help Show help options.
56
57
58       -i, --stdin Open up a pipe to pass stdin to the container.
59
60
61       This  option tells conmon to setup the pipe regardless of whether there
62       is a terminal connection.
63
64
65       -l, --log-path Path to store all stdout and stderr  messages  from  the
66       container.
67
68
69       --leave-stdin-open  Leave  stdin  open when the attached client discon‐
70       nects.
71
72
73       --log-level Print debug logs based on the log level.
74
75
76       --log-size-max Maximum size of the log file.
77
78
79       --log-tag Additional tag to use for logging.
80
81
82       -n, --name Container name.
83
84
85       --no-new-keyring Do not create a new session keyring for the container.
86
87
88       --no-pivot Do not use pivot_root.
89
90
91       --no-sync-log Do not manually call sync on logs after  container  shut‐
92       down.
93
94
95       -0, --persist-dir Persistent directory for a container that can be used
96       for storing container data.
97
98
99       -p, --container-pidfile PID file for the initial pid inside of the con‐
100       tainer.
101
102
103       -P, --conmon-pidfile PID file for the conmon process.
104
105
106       -r, --runtime Path to store runtime data for the container.
107
108
109       --replace-listen-pid Replace listen pid if set for oci-runtime pid.
110
111
112       --restore Restore a container from a checkpoint.
113
114
115       --runtime-arg Additional arguments to pass to the runtime. Can be spec‐
116       ified multiple times.
117
118
119       --runtime-opt Additional options to pass to the restore  or  exec  com‐
120       mand. Can be specified multiple times.
121
122
123       -s, --systemd-cgroup Enable systemd cgroup manager, rather then use the
124       cgroupfs directly.
125
126
127       --socket-dir-path Location of container attach sockets.
128
129
130       --sync Keep the main conmon process as its child by only forking once.
131
132
133       --syslog Log to syslog (use with cgroupfs cgroup manager).
134
135
136       -t, --terminal Allocate a pseudo-TTY. The default is false.
137
138
139       When set to true, conmon will allocate a pseudo-tty and attach  to  the
140       standard  input of the container. This can be used, for example, to run
141       a throwaway interactive shell. The default is false.
142
143
144       -T, --timeout Kill container after specified timeout in seconds.
145
146
147       -u, --cuuid Specify the Container UUID to use.
148
149
150       --version Print the version and exit.
151
152

SEE ALSO

154       podman(1), buildah(1), cri-o(1), crun(8), runc(8)
155
156

HISTORY

158       October  2020,  Originally  compiled  by  Dan  Walsh  dwalsh@redhat.com
159       ⟨mailto:dwalsh@redhat.com⟩
160
161
162
163                                 User Commands                       conmon(8)