Update docs for StopTimeOut

Signed-off-by: ByoungUk Lee <[email protected]>

Author: nimdrak

docs/source/markdown/podman-systemd.unit.5.md

@@ -1021,32 +1021,33 @@ a `$name.pod` file creates a `$name-pod.service` unit and a `systemd-$name` Podm
 
 Valid options for `[Pod]` are listed below:
 
-| **[Pod] options**                   | **podman pod create equivalent** |
-|-------------------------------------|----------------------------------------|
-| AddHost=example\.com:192.168.10.11  | --add-host example.com:192.168.10.11   |
-| ContainersConfModule=/etc/nvd\.conf | --module=/etc/nvd\.conf                |
-| DNS=192.168.55.1                    | --dns=192.168.55.1                     |
-| DNSOption=ndots:1                   | --dns-option=ndots:1                   |
-| DNSSearch=example.com               | --dns-search example.com               |
-| ExitPolicy=stop                     | --exit-policy stop                     |
-| GIDMap=0:10000:10                   | --gidmap=0:10000:10                    |
-| GlobalArgs=--log-level=debug        | --log-level=debug                      |
-| HostName=name                       | --hostname=name                        |
-| IP=192.5.0.1                        | --ip 192.5.0.1                         |
-| IP6=2001:db8::1                     | --ip6 2001:db8::1                      |
-| Label="XYZ"                         | --label "XYZ"                          |
-| Network=host                        | --network host                         |
-| NetworkAlias=name                   | --network-alias name                   |
-| PodmanArgs=\-\-cpus=2               | --cpus=2                               |
-| PodName=name                        | --name=name                            |
-| PublishPort=8080:80                 | --publish 8080:80                      |
-| ServiceName=name                    | Name the systemd unit `name.service`   |
-| ShmSize=100m                        | --shm-size=100m                        |
-| SubGIDMap=gtest                     | --subgidname=gtest                     |
-| SubUIDMap=utest                     | --subuidname=utest                     |
-| UIDMap=0:10000:10                   | --uidmap=0:10000:10                    |
-| UserNS=keep-id:uid=200,gid=210      | --userns keep-id:uid=200,gid=210       |
-| Volume=/source:/dest                | --volume /source:/dest                 |
+| **[Pod] options**                   | **podman pod create equivalent**      |
+|-------------------------------------|---------------------------------------|
+| AddHost=example\.com:192.168.10.11  | --add-host example.com:192.168.10.11  |
+| ContainersConfModule=/etc/nvd\.conf | --module=/etc/nvd\.conf               |
+| DNS=192.168.55.1                    | --dns=192.168.55.1                    |
+| DNSOption=ndots:1                   | --dns-option=ndots:1                  |
+| DNSSearch=example.com               | --dns-search example.com              |
+| ExitPolicy=stop                     | --exit-policy stop                    |
+| GIDMap=0:10000:10                   | --gidmap=0:10000:10                   |
+| GlobalArgs=--log-level=debug        | --log-level=debug                     |
+| HostName=name                       | --hostname=name                       |
+| IP=192.5.0.1                        | --ip 192.5.0.1                        |
+| IP6=2001:db8::1                     | --ip6 2001:db8::1                     |
+| Label="XYZ"                         | --label "XYZ"                         |
+| Network=host                        | --network host                        |
+| NetworkAlias=name                   | --network-alias name                  |
+| PodmanArgs=\-\-cpus=2               | --cpus=2                              |
+| PodName=name                        | --name=name                           |
+| PublishPort=8080:80                 | --publish 8080:80                     |
+| ServiceName=name                    | Name the systemd unit `name.service`  |
+| ShmSize=100m                        | --shm-size=100m                       |
+| StopTimeout=20                      | --time=20                             |
+| SubGIDMap=gtest                     | --subgidname=gtest                    |
+| SubUIDMap=utest                     | --subuidname=utest                    |
+| UIDMap=0:10000:10                   | --uidmap=0:10000:10                   |
+| UserNS=keep-id:uid=200,gid=210      | --userns keep-id:uid=200,gid=210      |
+| Volume=/source:/dest                | --volume /source:/dest                |
 
 Supported keys in the `[Pod]` section are:
 
@@ -1210,6 +1211,12 @@ Size of /dev/shm.
 
 This is equivalent to the Podman `--shm-size` option and generally has the form `number[unit]`
 
+### `StopTimeout=`
+
+Sets the time in seconds to wait for the pod to gracefully stop. 
+This value is equivalent to the `--time` argument in the podman `pod stop` command when the service is stopped. 
+After this period expires, any running containers in the pod are forcibly killed.
+
 ### `SubGIDMap=`
 
 Create the pod in a new user namespace using the map with name in the /etc/subgid file.