package client // import "github.com/docker/docker/client"

 
 import (

 	"context"

 	"net/url"
 	"time"
 
 	timetypes "github.com/docker/docker/api/types/time"
 )
 

 // ContainerStop stops a container. In case the container fails to stop
 // gracefully within a time frame specified by the timeout argument,
 // it is forcefully terminated (killed).
 //
 // If the timeout is nil, the container's StopTimeout value is used, if set,
 // otherwise the engine default. A negative timeout value can be specified,
 // meaning no timeout, i.e. no forceful termination is performed.

 func (cli *Client) ContainerStop(ctx context.Context, containerID string, timeout *time.Duration) error {
 	query := url.Values{}
 	if timeout != nil {
 		query.Set("t", timetypes.DurationToSecondsString(*timeout))
 	}
 	resp, err := cli.post(ctx, "/containers/"+containerID+"/stop", query, nil, nil)
 	ensureReaderClosed(resp)
 	return err
 }