v1.10.3-ros1 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Mar 18, 2016 License: Apache-2.0 Imports: 80 Imported by: 0



Package client provides a command-line interface for Docker.

Run "docker help SUBCOMMAND" or "docker SUBCOMMAND --help" to see more information on any Docker subcommand, including the full list of options supported for the subcommand. See for instructions on installing Docker.



This section is empty.


This section is empty.


func ParseExec

func ParseExec(cmd *flag.FlagSet, args []string) (*types.ExecConfig, error)

ParseExec parses the specified args for the specified command and generates an ExecConfig from it. If the minimal number of specified args is not right or if specified args are not valid, it will return an error.


type DockerCli

type DockerCli struct {
	// contains filtered or unexported fields

DockerCli represents the docker command line client. Instances of the client can be returned from NewDockerCli.

func NewDockerCli

func NewDockerCli(in io.ReadCloser, out, err io.Writer, clientFlags *cli.ClientFlags) *DockerCli

NewDockerCli returns a DockerCli instance with IO output and error streams set by in, out and err. The key file, protocol (i.e. unix) and address are passed in as strings, along with the tls.Config. If the tls.Config is set the client scheme will be set to https. The client will be given a 32-second timeout (see

func (*DockerCli) CheckTtyInput

func (cli *DockerCli) CheckTtyInput(attachStdin, ttyMode bool) error

CheckTtyInput checks if we are trying to attach to a container tty from a non-tty client input stream, and if so, returns an error.

func (*DockerCli) CmdAttach

func (cli *DockerCli) CmdAttach(args ...string) error

CmdAttach attaches to a running container.

Usage: docker attach [OPTIONS] CONTAINER

func (*DockerCli) CmdBuild

func (cli *DockerCli) CmdBuild(args ...string) error

CmdBuild builds a new image from the source code at a given path.

If '-' is provided instead of a path or URL, Docker will build an image from either a Dockerfile or tar archive read from STDIN.

Usage: docker build [OPTIONS] PATH | URL | -

func (*DockerCli) CmdCommit

func (cli *DockerCli) CmdCommit(args ...string) error

CmdCommit creates a new image from a container's changes.


func (*DockerCli) CmdCp

func (cli *DockerCli) CmdCp(args ...string) error

CmdCp copies files/folders to or from a path in a container.

When copying from a container, if DEST_PATH is '-' the data is written as a tar archive file to STDOUT.

When copying to a container, if SRC_PATH is '-' the data is read as a tar archive file from STDIN, and the destination CONTAINER:DEST_PATH, must specify a directory.



func (*DockerCli) CmdCreate

func (cli *DockerCli) CmdCreate(args ...string) error

CmdCreate creates a new container from a given image.

Usage: docker create [OPTIONS] IMAGE [COMMAND] [ARG...]

func (*DockerCli) CmdDiff

func (cli *DockerCli) CmdDiff(args ...string) error

CmdDiff shows changes on a container's filesystem.

Each changed file is printed on a separate line, prefixed with a single character that indicates the status of the file: C (modified), A (added), or D (deleted).

Usage: docker diff CONTAINER

func (*DockerCli) CmdEvents

func (cli *DockerCli) CmdEvents(args ...string) error

CmdEvents prints a live stream of real time events from the server.

Usage: docker events [OPTIONS]

func (*DockerCli) CmdExec

func (cli *DockerCli) CmdExec(args ...string) error

CmdExec runs a command in a running container.

Usage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

func (*DockerCli) CmdExport

func (cli *DockerCli) CmdExport(args ...string) error

CmdExport exports a filesystem as a tar archive.

The tar archive is streamed to STDOUT by default or written to a file.

Usage: docker export [OPTIONS] CONTAINER

func (*DockerCli) CmdHistory

func (cli *DockerCli) CmdHistory(args ...string) error

CmdHistory shows the history of an image.

Usage: docker history [OPTIONS] IMAGE

func (*DockerCli) CmdImages

func (cli *DockerCli) CmdImages(args ...string) error

CmdImages lists the images in a specified repository, or all top-level images if no repository is specified.

Usage: docker images [OPTIONS] [REPOSITORY]

func (*DockerCli) CmdImport

func (cli *DockerCli) CmdImport(args ...string) error

CmdImport creates an empty filesystem image, imports the contents of the tarball into the image, and optionally tags the image.

The URL argument is the address of a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) file or a path to local file relative to docker client. If the URL is '-', then the tar file is read from STDIN.

Usage: docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]

func (*DockerCli) CmdInfo

func (cli *DockerCli) CmdInfo(args ...string) error

CmdInfo displays system-wide information.

Usage: docker info

func (*DockerCli) CmdInspect

func (cli *DockerCli) CmdInspect(args ...string) error

CmdInspect displays low-level information on one or more containers or images.


func (*DockerCli) CmdKill

func (cli *DockerCli) CmdKill(args ...string) error

CmdKill kills one or more running container using SIGKILL or a specified signal.

Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdLoad

func (cli *DockerCli) CmdLoad(args ...string) error

CmdLoad loads an image from a tar archive.

The tar archive is read from STDIN by default, or from a tar archive file.

Usage: docker load [OPTIONS]

func (*DockerCli) CmdLogin

func (cli *DockerCli) CmdLogin(args ...string) error

CmdLogin logs in or registers a user to a Docker registry service.

If no server is specified, the user will be logged into or registered to the registry's index server.

Usage: docker login SERVER

func (*DockerCli) CmdLogout

func (cli *DockerCli) CmdLogout(args ...string) error

CmdLogout logs a user out from a Docker registry.

If no server is specified, the user will be logged out from the registry's index server.

Usage: docker logout [SERVER]

func (*DockerCli) CmdLogs

func (cli *DockerCli) CmdLogs(args ...string) error

CmdLogs fetches the logs of a given container.


func (*DockerCli) CmdNetwork

func (cli *DockerCli) CmdNetwork(args ...string) error

CmdNetwork is the parent subcommand for all network commands

Usage: docker network <COMMAND> [OPTIONS]

func (*DockerCli) CmdNetworkConnect

func (cli *DockerCli) CmdNetworkConnect(args ...string) error

CmdNetworkConnect connects a container to a network

Usage: docker network connect [OPTIONS] <NETWORK> <CONTAINER>

func (*DockerCli) CmdNetworkCreate

func (cli *DockerCli) CmdNetworkCreate(args ...string) error

CmdNetworkCreate creates a new network with a given name

Usage: docker network create [OPTIONS] <NETWORK-NAME>

func (*DockerCli) CmdNetworkDisconnect

func (cli *DockerCli) CmdNetworkDisconnect(args ...string) error

CmdNetworkDisconnect disconnects a container from a network

Usage: docker network disconnect <NETWORK> <CONTAINER>

func (*DockerCli) CmdNetworkInspect

func (cli *DockerCli) CmdNetworkInspect(args ...string) error

CmdNetworkInspect inspects the network object for more details

Usage: docker network inspect [OPTIONS] <NETWORK> [NETWORK...]

func (*DockerCli) CmdNetworkLs

func (cli *DockerCli) CmdNetworkLs(args ...string) error

CmdNetworkLs lists all the networks managed by docker daemon

Usage: docker network ls [OPTIONS]

func (*DockerCli) CmdNetworkRm

func (cli *DockerCli) CmdNetworkRm(args ...string) error

CmdNetworkRm deletes one or more networks


func (*DockerCli) CmdPause

func (cli *DockerCli) CmdPause(args ...string) error

CmdPause pauses all processes within one or more containers.

Usage: docker pause CONTAINER [CONTAINER...]

func (*DockerCli) CmdPort

func (cli *DockerCli) CmdPort(args ...string) error

CmdPort lists port mappings for a container. If a private port is specified, it also shows the public-facing port that is NATed to the private port.


func (*DockerCli) CmdPs

func (cli *DockerCli) CmdPs(args ...string) error

CmdPs outputs a list of Docker containers.

Usage: docker ps [OPTIONS]

func (*DockerCli) CmdPull

func (cli *DockerCli) CmdPull(args ...string) error

CmdPull pulls an image or a repository from the registry.

Usage: docker pull [OPTIONS] IMAGENAME[:TAG|@DIGEST]

func (*DockerCli) CmdPush

func (cli *DockerCli) CmdPush(args ...string) error

CmdPush pushes an image or repository to the registry.

Usage: docker push NAME[:TAG]

func (*DockerCli) CmdRename

func (cli *DockerCli) CmdRename(args ...string) error

CmdRename renames a container.

Usage: docker rename OLD_NAME NEW_NAME

func (*DockerCli) CmdRestart

func (cli *DockerCli) CmdRestart(args ...string) error

CmdRestart restarts one or more containers.

Usage: docker restart [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdRm

func (cli *DockerCli) CmdRm(args ...string) error

CmdRm removes one or more containers.


func (*DockerCli) CmdRmi

func (cli *DockerCli) CmdRmi(args ...string) error

CmdRmi removes all images with the specified name(s).

Usage: docker rmi [OPTIONS] IMAGE [IMAGE...]

func (*DockerCli) CmdRun

func (cli *DockerCli) CmdRun(args ...string) error

CmdRun runs a command in a new container.

Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

func (*DockerCli) CmdSave

func (cli *DockerCli) CmdSave(args ...string) error

CmdSave saves one or more images to a tar archive.

The tar archive is written to STDOUT by default, or written to a file.

Usage: docker save [OPTIONS] IMAGE [IMAGE...]

func (*DockerCli) CmdSearch

func (cli *DockerCli) CmdSearch(args ...string) error

CmdSearch searches the Docker Hub for images.

Usage: docker search [OPTIONS] TERM

func (*DockerCli) CmdStart

func (cli *DockerCli) CmdStart(args ...string) error

CmdStart starts one or more containers.

Usage: docker start [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdStats

func (cli *DockerCli) CmdStats(args ...string) error

CmdStats displays a live stream of resource usage statistics for one or more containers.

This shows real-time information on CPU usage, memory usage, and network I/O.

Usage: docker stats [OPTIONS] [CONTAINER...]

func (*DockerCli) CmdStop

func (cli *DockerCli) CmdStop(args ...string) error

CmdStop stops one or more containers.

A running container is stopped by first sending SIGTERM and then SIGKILL if the container fails to stop within a grace period (the default is 10 seconds).

Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdTag

func (cli *DockerCli) CmdTag(args ...string) error

CmdTag tags an image into a repository.


func (*DockerCli) CmdTop

func (cli *DockerCli) CmdTop(args ...string) error

CmdTop displays the running processes of a container.

Usage: docker top CONTAINER

func (*DockerCli) CmdUnpause

func (cli *DockerCli) CmdUnpause(args ...string) error

CmdUnpause unpauses all processes within a container, for one or more containers.

Usage: docker unpause CONTAINER [CONTAINER...]

func (*DockerCli) CmdUpdate

func (cli *DockerCli) CmdUpdate(args ...string) error

CmdUpdate updates resources of one or more containers.

Usage: docker update [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdVersion

func (cli *DockerCli) CmdVersion(args ...string) (err error)

CmdVersion shows Docker version information.

Available version information is shown for: client Docker version, client API version, client Go version, client Git commit, client OS/Arch, server Docker version, server API version, server Go version, server Git commit, and server OS/Arch.

Usage: docker version

func (*DockerCli) CmdVolume

func (cli *DockerCli) CmdVolume(args ...string) error

CmdVolume is the parent subcommand for all volume commands

Usage: docker volume <COMMAND> <OPTS>

func (*DockerCli) CmdVolumeCreate

func (cli *DockerCli) CmdVolumeCreate(args ...string) error

CmdVolumeCreate creates a new volume.

Usage: docker volume create [OPTIONS]

func (*DockerCli) CmdVolumeInspect

func (cli *DockerCli) CmdVolumeInspect(args ...string) error

CmdVolumeInspect displays low-level information on one or more volumes.

Usage: docker volume inspect [OPTIONS] VOLUME [VOLUME...]

func (*DockerCli) CmdVolumeLs

func (cli *DockerCli) CmdVolumeLs(args ...string) error

CmdVolumeLs outputs a list of Docker volumes.

Usage: docker volume ls [OPTIONS]

func (*DockerCli) CmdVolumeRm

func (cli *DockerCli) CmdVolumeRm(args ...string) error

CmdVolumeRm removes one or more volumes.

Usage: docker volume rm VOLUME [VOLUME...]

func (*DockerCli) CmdWait

func (cli *DockerCli) CmdWait(args ...string) error

CmdWait blocks until a container stops, then prints its exit code.

If more than one container is specified, this will wait synchronously on each container.

Usage: docker wait CONTAINER [CONTAINER...]

func (*DockerCli) ImagesFormat

func (cli *DockerCli) ImagesFormat() string

ImagesFormat returns the format string specified in the configuration. String contains columns and format specification, for example {{ID}}\t{{Name}}.

func (*DockerCli) Initialize

func (cli *DockerCli) Initialize() error

Initialize calls the init function that will setup the configuration for the client such as the TLS, tcp and other parameters used to run the client.

func (*DockerCli) PsFormat

func (cli *DockerCli) PsFormat() string

PsFormat returns the format string specified in the configuration. String contains columns and format specification, for example {{ID}}\t{{Name}}.


Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL