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.27 1.27.5-r3 (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-node-readiness-condition
    	If set to true, the node driver sets the --node-readiness-condition-type condition to True on its Node once csi-driver-registrar is healthy.
  -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 127.0.0.1:8080
    	The TCP network address where the prometheus metrics endpoint will listen (example: 127.0.0.1:8080). The default is empty string, which means metrics endpoint is disabled. The endpoint contains internal system state (go runtime), which can help attackers better understand system internals, so should not be publicly exposed
  -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
  -node-readiness-condition-type string
    	The Node condition type set when --enable-node-readiness-condition is true. (default "pd.csi.storage.gke.io/Ready")
  -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)
  -registrar-healthz-endpoint string
    	The host:port of the csi-driver-registrar healthz endpoint polled by the node readiness reporter. (default "127.0.0.1:9931")
  -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 (76)
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-node-readiness-conditionIf set to true, the node driver sets the --node-readiness-condition-type condition to True on its Node once csi-driver-registrar is healthy.help
-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 127.0.0.1:8080The TCP network address where the prometheus metrics endpoint will listen (example: 127.0.0.1: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
-node-readiness-condition-type stringThe Node condition type set when --enable-node-readiness-condition is true.help
-one_outputIf true, only write logs to their native severity level (vs also writing to each lower severity level;help
-registrar-healthz-endpoint stringThe host:port of the csi-driver-registrar healthz endpoint polled by the node readiness reporter.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.