OS Manuals

/usr/bin/hostpathplugin

A sample (non-production) CSI Driver that creates a local directory as a volume on a single node

From kubernetes-csi-driver-hostpath 1.19.0-r2 (os), captured 2026-11-05 by running hostpathplugin --help (exit 0). permalink

Usage of /usr/bin/hostpathplugin:
  -accepted-mutable-parameter-names value
    	Comma separated list of parameter names that can be modified on a persistent volume. This is only used when enable-controller-modify-volume is true. If unset, all parameters are mutable.
  -add_dir_header
    	If true, adds the file directory to the header of the log messages
  -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-limit int
    	Maximum number of attachable volumes on a node. Zero refers to no limit.
  -automaxprocs
    	automatically set GOMAXPROCS to match Linux container CPU quota
  -capacity value
    	Simulate storage capacity. The parameter is <kind>=<quantity> where <kind> is the value of a 'kind' storage class parameter and <quantity> is the total amount of bytes for that kind. The flag may be used multiple times to configure different kinds.
  -check-volume-lifecycle
    	Can be used to turn some violations of the volume lifecycle into warnings instead of failing the incorrect gRPC call. Disabled by default because of https://github.com/kubernetes/kubernetes/issues/101911.
  -disable-controller-expansion
    	Disables Controller volume expansion capability.
  -disable-node-expansion
    	Disables Node volume expansion capability.
  -drivername string
    	name of the driver (default "hostpath.csi.k8s.io")
  -enable-attach
    	Enables RPC_PUBLISH_UNPUBLISH_VOLUME capability.
  -enable-controller-modify-volume
    	Enables Controller modify volume feature.
  -enable-list-snapshots
    	Enables ControllerServiceCapability_RPC_LIST_SNAPSHOTS capability. Defaults to true. (default true)
  -enable-snapshot-metadata
    	Enables Snapshot Metadata service.
  -enable-topology
    	Enables PluginCapability_Service_VOLUME_ACCESSIBILITY_CONSTRAINTS capability. (default true)
  -enable-volume-expansion
    	Enables volume expansion feature. (default true)
  -endpoint string
    	CSI endpoint (default "unix:///tmp/csi.sock")
  -ephemeral
    	publish volumes in ephemeral mode even if kubelet did not ask for it (only needed for Kubernetes 1.15)
  -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-volume-size int
    	maximum size of volumes in bytes (inclusive) (default 1099511627776)
  -max-volume-size-node int
    	Maximum allowed size of volume when expanded on the node. Defaults to same size as max-volume-size.
  -maxvolumespernode int
    	limit of volumes per node
  -node-expand-required
    	Enables volume expansion capability of the plugin(Deprecated). Please use enable-volume-expansion flag. (default true)
  -nodeid string
    	node id
  -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)
  -proxy-endpoint string
    	Instead of running the CSI driver code, just proxy connections from csiEndpoint to the given listening socket.
  -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)
  -snapshot-metadata-block-type string
    	Expected Snapshot Metadata block type in response. Allowed valid types are FIXED_LENGTH or VARIABLE_LENGTH. If not specified, FIXED_LENGTH is used by default. (default "FIXED_LENGTH")
  -statedir string
    	directory for storing state information across driver restarts, volumes and snapshots (default "/csi-data-dir")
  -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)
  -v value
    	number for the log level verbosity
  -version
    	Show version.
  -vmodule value
    	comma-separated list of pattern=N settings for file-filtered logging
Options (40)
OptionDescriptionSource
-accepted-mutable-parameter-names valueComma separated list of parameter names that can be modified on a persistent volume.help
-add_dir_headerIf true, adds the file directory to the header of the log messageshelp
-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-limit intMaximum number of attachable volumes on a node.help
-automaxprocsautomatically set GOMAXPROCS to match Linux container CPU quotahelp
-capacity valueSimulate storage capacity.help
-check-volume-lifecycleCan be used to turn some violations of the volume lifecycle into warnings instead of failing the incorrect gRPC call.help
-disable-controller-expansionDisables Controller volume expansion capability.help
-disable-node-expansionDisables Node volume expansion capability.help
-drivername stringname of the driver (default "hostpath.csi.k8s.io")help
-enable-attachEnables RPC_PUBLISH_UNPUBLISH_VOLUME capability.help
-enable-controller-modify-volumeEnables Controller modify volume feature.help
-enable-list-snapshotsEnables ControllerServiceCapability_RPC_LIST_SNAPSHOTS capability.help
-enable-snapshot-metadataEnables Snapshot Metadata service.help
-enable-topologyEnables PluginCapability_Service_VOLUME_ACCESSIBILITY_CONSTRAINTS capability.help
-enable-volume-expansionEnables volume expansion feature.help
-endpoint stringCSI endpoint (default "unix:///tmp/csi.sock")help
-ephemeralpublish volumes in ephemeral mode even if kubelet did not ask for it (only needed for Kubernetes 1.15)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-volume-size intmaximum size of volumes in bytes (inclusive) (default 1099511627776)help
-max-volume-size-node intMaximum allowed size of volume when expanded on the node.help
-maxvolumespernode intlimit of volumes per nodehelp
-node-expand-requiredEnables volume expansion capability of the plugin(Deprecated).help
-nodeid stringnode idhelp
-one_outputIf true, only write logs to their native severity level (vs also writing to each lower severity level;help
-proxy-endpoint stringInstead of running the CSI driver code, just proxy connections from csiEndpoint to the given listening socket.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
-snapshot-metadata-block-type stringExpected Snapshot Metadata block type in response.help
-statedir stringdirectory for storing state information across driver restarts, volumes and snapshots (default "/csi-data-dir")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
-v valuenumber for the log level verbosityhelp
-versionShow version.help
-vmodule valuecomma-separated list of pattern=N settings for file-filtered logginghelp

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