OS Manuals

/usr/bin/gce-pd-csi-driver

The Google Compute Engine Persistent Disk (GCE PD) Container Storage Interface (CSI) Storage Plugin.

From gcp-compute-persistent-disk-csi-driver-fips-1.19 1.19.1-r40 (enterprise-packages), captured 2026-11-08 by running gce-pd-csi-driver --help (exit 0). permalink

Usage of /usr/bin/gce-pd-csi-driver:
  -add_dir_header
    	If true, adds the file directory to the header of the log messages
  -allow-hdha-provisioning
    	If set to true, will allow the driver to provision Hyperdisk-balanced High Availability disks
  -alsologtostderr
    	log to standard error as well as files (no effect when -logtostderr=true)
  -attach-disk-backoff-cap duration
    	Cap for attachDisk backoff
  -attach-disk-backoff-duration duration
    	Duration for attachDisk backoff (default 5s)
  -attach-disk-backoff-factor float
    	Factor for attachDisk backoff
  -attach-disk-backoff-jitter float
    	Jitter for attachDisk backoff
  -attach-disk-backoff-steps int
    	Steps for attachDisk backoff (default 24)
  -backoff-initial-duration-ms int
    	The amount of ms for the initial duration of the backoff condition for controller publish/unpublish CSI operations. Default is 200. (default 200)
  -backoff-max-duration-ms int
    	The amount of ms for the max duration of the backoff condition for controller publish/unpublish CSI operations. Default is 300000 (5m). (default 300000)
  -cloud-config string
    	Path to GCE cloud provider config
  -compute-endpoint value
    	Compute endpoint
  -compute-environment value
    	Operating compute environment
  -concurrent-format-timeout duration
    	The maximum duration of a format operation before its concurrency token is released (default 1m0s)
  -device-in-use-timeout duration
    	Max time to wait for a device to be unused when attempting to unstage. Exceeding the timeout will cause an unstage request to return success and ignore the device in use check. (default 30s)
  -disk-topology
    	If set to true, the driver will add a disk-type.gke.io/[disk-type] topology label when the StorageClass has the use-allowed-disk-topology parameter set to true. That topology label is included in the Topologies returned in CreateVolumeResponse. This flag is disabled by default.
  -enable-data-cache
    	If set to true, the CSI Driver will allow volumes to be provisioned with Data Cache configuration
  -enable-device-in-use-check-on-node-unstage
    	If set to true, block NodeUnstageVolume requests until the specified device is not in use (default true)
  -enable-otel-tracing
    	If set, enable opentelemetry tracing for the driver. The tracing is disabled by default. Configure the exporter endpoint with OTEL_EXPORTER_OTLP_ENDPOINT and other env variables, see https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/#general-sdk-configuration.
  -enable-storage-pools
    	If set to true, the CSI Driver will allow volumes to be provisioned in Storage Pools
  -endpoint string
    	CSI endpoint (default "unix:/tmp/csi.sock")
  -extra-labels string
    	Extra labels to attach to each PD created. It is a comma separated list of key value pairs like '<key1>=<value1>,<key2>=<value2>'. See https://cloud.google.com/compute/docs/labeling-resources for details
  -extra-tags string
    	Extra tags to attach to each Compute Disk, Image, Snapshot created. It is a comma separated list of parent id, key and value like '<parent_id1>/<tag_key1>/<tag_value1>,...,<parent_idN>/<tag_keyN>/<tag_valueN>'. parent_id is the Organization or the Project ID or Project name where the tag key and the tag value resources exist. A maximum of 50 tags bindings is allowed for a resource. See https://cloud.google.com/resource-manager/docs/tags/tags-overview, https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing for details
  -fallback-requisite-zones string
    	Comma separated list of requisite zones that will be used if there are not sufficient zones present in requisite topologies when provisioning a disk
  -format-and-mount-timeout duration
    	The maximum duration of a format and mount operation before another such operation will be started. Used only if --serialize-format-and-mount (default 1m0s)
  -grpc-log-char-cap int
    	The maximum amount of characters logged for every grpc responses (default 10000)
  -http-endpoint :8080
    	The TCP network address where the prometheus metrics endpoint will listen (example: :8080). The default is empty string, which means metrics endpoint is disabled.
  -instances-list-filters string
    	Comma separated list of filters to use when calling the instances.list API. By default instances.list fetches all instances in a region
  -log_backtrace_at value
    	when logging hits line file:N, emit a stack trace
  -log_dir string
    	If non-empty, write log files in this directory (no effect when -logtostderr=true)
  -log_file string
    	If non-empty, use this log file (no effect when -logtostderr=true)
  -log_file_max_size uint
    	Defines the maximum size a log file can grow to (no effect when -logtostderr=true). Unit is megabytes. If the value is 0, the maximum file size is unlimited. (default 1800)
  -logtostderr
    	log to standard error instead of files (default true)
  -max-concurrent-format int
    	The maximum number of concurrent format exec calls (default 1)
  -max-concurrent-format-and-mount int
    	If set then format and mount operations are serialized on each node. This is stronger than max-concurrent-format as it includes fsck and other mount operations (default 1)
  -maxprocs int
    	GOMAXPROCS override (default 1)
  -metrics-path /metrics
    	The HTTP path where prometheus metrics will be exposed. Default is /metrics. (default "/metrics")
  -multi-zone-volume-handle-disk-types string
    	Comma separated list of allowed disk types that can use the multi-zone volumeHandle. Used only if --multi-zone-volume-handle-enable
  -multi-zone-volume-handle-enable
    	If set to true, the multi-zone volumeHandle feature will be enabled
  -node-name string
    	The node this driver is running on
  -one_output
    	If true, only write logs to their native severity level (vs also writing to each lower severity level; no effect when -logtostderr=true)
  -run-controller-service
    	If set to false then the CSI driver does not activate its controller service (default: true) (default true)
  -run-node-service
    	If set to false then the CSI driver does not activate its node service (default: true) (default true)
  -skip_headers
    	If true, avoid header prefixes in the log messages
  -skip_log_headers
    	If true, avoid headers when opening log files (no effect when -logtostderr=true)
  -stderrthreshold value
    	logs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)
  -supports-dynamic-iops-provisioning string
    	Comma separated list of disk types that support dynamic IOPS provisioning
  -supports-dynamic-throughput-provisioning string
    	Comma separated list of disk types that support dynamic throughput provisioning
  -use-instance-api-to-list-volumes-published-nodes
    	Enables using the instances.list API to determine published_node_ids in ListVolumes. When false (default), the disks.list API is used
  -use-instance-api-to-poll-attachment-disk-types string
    	Comma separated list of disk types that should use instances.get API when polling for disk attach during ControllerPublish
  -v value
    	number for the log level verbosity
  -vmodule value
    	comma-separated list of pattern=N settings for file-filtered logging
  -wait-op-backoff-cap duration
    	Cap for wait for operation backoff
  -wait-op-backoff-duration duration
    	Duration for wait for operation backoff (default 3s)
  -wait-op-backoff-factor float
    	Factor for wait for operation backoff
  -wait-op-backoff-jitter float
    	Jitter for wait for operation backoff
  -wait-op-backoff-steps int
    	Steps for wait for operation backoff (default 100)
Options (57)
OptionDescriptionSource
-add_dir_headerIf true, adds the file directory to the header of the log messageshelp
-allow-hdha-provisioningIf set to true, will allow the driver to provision Hyperdisk-balanced High Availability diskshelp
-alsologtostderrlog to standard error as well as files (no effect when -logtostderr=true)help
-attach-disk-backoff-cap durationCap for attachDisk backoffhelp
-attach-disk-backoff-duration durationDuration for attachDisk backoff (default 5s)help
-attach-disk-backoff-factor floatFactor for attachDisk backoffhelp
-attach-disk-backoff-jitter floatJitter for attachDisk backoffhelp
-attach-disk-backoff-steps intSteps for attachDisk backoff (default 24)help
-backoff-initial-duration-ms intThe amount of ms for the initial duration of the backoff condition for controller publish/unpublish CSI operations.help
-backoff-max-duration-ms intThe amount of ms for the max duration of the backoff condition for controller publish/unpublish CSI operations.help
-cloud-config stringPath to GCE cloud provider confighelp
-compute-endpoint valueCompute endpointhelp
-compute-environment valueOperating compute environmenthelp
-concurrent-format-timeout durationThe maximum duration of a format operation before its concurrency token is released (default 1m0s)help
-device-in-use-timeout durationMax time to wait for a device to be unused when attempting to unstage.help
-disk-topologyIf set to true, the driver will add a disk-type.gke.io/[disk-type] topology label when the StorageClass has the use-allowed-disk-topology parameter set to true.help
-enable-data-cacheIf set to true, the CSI Driver will allow volumes to be provisioned with Data Cache configurationhelp
-enable-device-in-use-check-on-node-unstageIf set to true, block NodeUnstageVolume requests until the specified device is not in use (default true)help
-enable-otel-tracingIf set, enable opentelemetry tracing for the driver.help
-enable-storage-poolsIf set to true, the CSI Driver will allow volumes to be provisioned in Storage Poolshelp
-endpoint stringCSI endpoint (default "unix:/tmp/csi.sock")help
-extra-labels stringExtra labels to attach to each PD created.help
-extra-tags stringExtra tags to attach to each Compute Disk, Image, Snapshot created.help
-fallback-requisite-zones stringComma separated list of requisite zones that will be used if there are not sufficient zones present in requisite topologies when provisioning a diskhelp
-format-and-mount-timeout durationThe maximum duration of a format and mount operation before another such operation will be started.help
-grpc-log-char-cap intThe maximum amount of characters logged for every grpc responses (default 10000)help
-http-endpoint :8080The TCP network address where the prometheus metrics endpoint will listen (example: :8080).help
-instances-list-filters stringComma separated list of filters to use when calling the instances.list API.help
-log_backtrace_at valuewhen logging hits line file:N, emit a stack tracehelp
-log_dir stringIf non-empty, write log files in this directory (no effect when -logtostderr=true)help
-log_file stringIf non-empty, use this log file (no effect when -logtostderr=true)help
-log_file_max_size uintDefines the maximum size a log file can grow to (no effect when -logtostderr=true).help
-logtostderrlog to standard error instead of files (default true)help
-max-concurrent-format intThe maximum number of concurrent format exec calls (default 1)help
-max-concurrent-format-and-mount intIf set then format and mount operations are serialized on each node.help
-maxprocs intGOMAXPROCS override (default 1)help
-metrics-path /metricsThe HTTP path where prometheus metrics will be exposed.help
-multi-zone-volume-handle-disk-types stringComma separated list of allowed disk types that can use the multi-zone volumeHandle.help
-multi-zone-volume-handle-enableIf set to true, the multi-zone volumeHandle feature will be enabledhelp
-node-name stringThe node this driver is running onhelp
-one_outputIf true, only write logs to their native severity level (vs also writing to each lower severity level;help
-run-controller-serviceIf set to false then the CSI driver does not activate its controller service (default: true) (default true)help
-run-node-serviceIf set to false then the CSI driver does not activate its node service (default: true) (default true)help
-skip_headersIf true, avoid header prefixes in the log messageshelp
-skip_log_headersIf true, avoid headers when opening log files (no effect when -logtostderr=true)help
-stderrthreshold valuelogs at or above this threshold go to stderr when writing to files and stderr (no effect when -logtostderr=true or -alsologtostderr=true) (default 2)help
-supports-dynamic-iops-provisioning stringComma separated list of disk types that support dynamic IOPS provisioninghelp
-supports-dynamic-throughput-provisioning stringComma separated list of disk types that support dynamic throughput provisioninghelp
-use-instance-api-to-list-volumes-published-nodesEnables using the instances.list API to determine published_node_ids in ListVolumes.help
-use-instance-api-to-poll-attachment-disk-types stringComma separated list of disk types that should use instances.get API when polling for disk attach during ControllerPublishhelp
-v valuenumber for the log level verbosityhelp
-vmodule valuecomma-separated list of pattern=N settings for file-filtered logginghelp
-wait-op-backoff-cap durationCap for wait for operation backoffhelp
-wait-op-backoff-duration durationDuration for wait for operation backoff (default 3s)help
-wait-op-backoff-factor floatFactor for wait for operation backoffhelp
-wait-op-backoff-jitter floatJitter for wait for operation backoffhelp
-wait-op-backoff-steps intSteps for wait for operation backoff (default 100)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.