aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/create-file-mode.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/create-file-mode.md')
-rw-r--r--docs/cmdline-opts/create-file-mode.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/docs/cmdline-opts/create-file-mode.md b/docs/cmdline-opts/create-file-mode.md
new file mode 100644
index 000000000..c6467d15a
--- /dev/null
+++ b/docs/cmdline-opts/create-file-mode.md
@@ -0,0 +1,23 @@
+---
+c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+SPDX-License-Identifier: curl
+Long: create-file-mode
+Arg: <mode>
+Help: File mode for created files
+Protocols: SFTP SCP FILE
+Category: sftp scp file upload
+Added: 7.75.0
+Multi: single
+See-also:
+ - ftp-create-dirs
+Example:
+ - --create-file-mode 0777 -T localfile sftp://example.com/new
+---
+
+# `--create-file-mode`
+
+When curl is used to create files remotely using one of the supported
+protocols, this option allows the user to set which 'mode' to set on the file
+at creation time, instead of the default 0644.
+
+This option takes an octal number as argument.