| Option Flag | Explanation |
--recursive-listing
-R |
Useful only when the command is list or ls to list the contents of a directory; the listing is done in a deep fashion, so that the subdirectories of each directory are shown, as well, in recursive fashion.
|
| --apply-on-exit |
When ncutil finishes running, do not merely attempt to commit the changes that were made but also apply them (force configd to notice the changes and apply them to the network state of the machine).
|
--prefpath {filepath}
-p {filepath} |
Use a preference file located at some alternate path (rather than the system default). The filepath MUST be canonical.
Useful to edit preference files copied from other machines or to create new preference files. Note that a when a new preference file is created a new location named Default is added immediately and made the current location for that file. When you use this flag all properties will be editable -- so be careful!
The ncutil_prefpath enviroment variable can be set with a (canonical) path, as well, to avoid having to enter the option with every ncutil run.
|
--hex-passwords
-H
--text-passwords |
Some wireless base stations may be configured to accept hexadecimal byte strings as passwords. Use the --hex-passwords or -H flags to interpret passwords as hexadecimal byte strings rather than plain text. Its antithesis, the --text-passwords flag, is enabled by default.
|
| --die-on-syntax-errors |
When run in pseudo-shell mode, ncutil will not exit unless an error is particularly nasty. This flag specifies that ANY error should cause the program to exit.
|
| --disable-ANSI-text |
Normally, error messages, warnings, and the pseudo-shell prompt are output to the terminal using ANSI color and boldfacing sequences. These sequences will show up as gibberish if the output is piped to a file or another program. Use this flag to force the program to output only the text, without the ANSI formatting.
|
--path-separator-string {string}
-P {string} |
By default, directory paths within ncutil are formed with the '/' character as the separator string between components. This flag is used to specify an alternate character string to be used as the path separator. For example, if a location or network service name in a preference store used the '/' character, the path separator could be set to '::' instead; subsequent paths would look like '::Location::Service'.
|