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-1.26 1.26.8-r0 (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)
  -alsologtostderrthreshold value
    	logs at or above this threshold go to stderr when -alsologtostderr=true (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
  -cluster-ownership-id string
    	The identifier for the cluster to which the CSI driver belongs. When specified, the id is applied to the GCE disk resource as a label
  -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-cache-sync-period duration
    	Period for the disk cache to check the /dev/disk/by-id/ directory and evaluate the symlinks (default 10m0s)
  -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.
  -dynamic-volumes
    	If set to true, the CSI driver will automatically select a compatible disk type based on the presence of the dynamic-volume parameter and disk types defined in the StorageClass. 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-disk-cleanup
    	If set to true, the CSI driver will run a routine on startup to cleanup leaked GCE disks resources. Requires the cluster-ownership-id flag to be set. Disabled by default.
  -enable-disk-size-validation
    	If set to true, the driver will validate that the requested disk size is matches the physical disk size. This flag is disabled by default.
  -enable-multitenancy
    	If set to true, the CSI Driver will support running on multitenant GKE clusters
  -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-pd-conversion
    	If set to true, the CSI Driver will attempt to convert eligible PD disks to be compatible with attaching machine types during the attach operation
  -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
  -fail-close-on-auth-error
    	If set to true, the CSI driver will fail its controller service to start if it cannot fetch the initial authentication token during startup. Default is false (legacy behavior).
  -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)
  -gce-disk-status
    	If set to true, the CSI driver will update the volume-publish-status-gke-io label on the GCE disk resource after successful attachment to indicate the attachment status. Disabled by default.
  -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
  -kubeconfig string
    	Paths to a kubeconfig. Only required if out-of-cluster.
  -legacy_stderr_threshold_behavior
    	If true, stderrthreshold is ignored when logtostderr=true (legacy behavior). If false, stderrthreshold is honored even when logtostderr=true (default true)
  -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)
  -run-taint-controller
    	Enables the Taint Cleanup Controller (watches CSINodes and removes startup taints once CSINode resource is created)
  -run-taint-webhook
    	Enables the Mutating Admission Webhook (adds startup taints to Nodes to delay workloads until the CSINode resource is created)
  -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 unless -legacy_stderr_threshold_behavior=false) (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
  -taint-metrics-addr string
    	The address the taint controller metrics endpoint binds to. (default ":8081")
  -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 2m0s)
  -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 3)
  -webhook-port int
    	The port for the admission webhook to listen on (default 9443)
Options (73)
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
-alsologtostderrthreshold valuelogs at or above this threshold go to stderr when -alsologtostderr=true (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
-cluster-ownership-id stringThe identifier for the cluster to which the CSI driver belongs.help
-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-cache-sync-period durationPeriod for the disk cache to check the /dev/disk/by-id/ directory and evaluate the symlinks (default 10m0s)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
-dynamic-volumesIf set to true, the CSI driver will automatically select a compatible disk type based on the presence of the dynamic-volume parameter and disk types defined in the StorageClass.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-disk-cleanupIf set to true, the CSI driver will run a routine on startup to cleanup leaked GCE disks resources.help
-enable-disk-size-validationIf set to true, the driver will validate that the requested disk size is matches the physical disk size.help
-enable-multitenancyIf set to true, the CSI Driver will support running on multitenant GKE clustershelp
-enable-otel-tracingIf set, enable opentelemetry tracing for the driver.help
-enable-pd-conversionIf set to true, the CSI Driver will attempt to convert eligible PD disks to be compatible with attaching machine types during the attach operationhelp
-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
-fail-close-on-auth-errorIf set to true, the CSI driver will fail its controller service to start if it cannot fetch the initial authentication token during startup.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
-gce-disk-statusIf set to true, the CSI driver will update the volume-publish-status-gke-io label on the GCE disk resource after successful attachment to indicate the attachment status.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
-kubeconfig stringPaths to a kubeconfig.help
-legacy_stderr_threshold_behaviorIf true, stderrthreshold is ignored when logtostderr=true (legacy behavior).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
-run-taint-controllerEnables the Taint Cleanup Controller (watches CSINodes and removes startup taints once CSINode resource is created)help
-run-taint-webhookEnables the Mutating Admission Webhook (adds startup taints to Nodes to delay workloads until the CSINode resource is created)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 unless -legacy_stderr_threshold_behavior=false) (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
-taint-metrics-addr stringThe address the taint controller metrics endpoint binds to.help
-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 2m0s)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 3)help
-webhook-port intThe port for the admission webhook to listen on (default 9443)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.