SFK: help options (Help)

Команда: help options

Справочник по общим параметрам sfk:

Обратите внимание: некоторые из этих опций поддерживаются только некоторыми командами.

общие параметры обработки
-var вставить переменные SFK, используя #(имя_переменной). введите это
вариант сразу после "sfk", чтобы использовать его глобально со всеми
команды в цепочке или скрипте. напечатать "#(" буквально
затем экранируйте его как ##(. для получения дополнительной информации о переменных
тип: sfk help var
-yes полностью выполнить команду. некоторые команды, такие как «выполнить»,
работает в режиме моделирования по умолчанию, чтобы избежать повреждения вашего
файлы, если вы не уверены, какие файлы и каталоги выбрать.
как только вы добавляете -yes, однако, все полностью выполняется.
-keepchain никогда не останавливает цепочку команд, даже если команды, ожидающие
имена файлов не получаются. подробности: справочная цепочка sfk
-upat unix-совместимый файл или выбор текста и шаблоны.
позволяет использовать -subdir :/tmp вместо !\tmp, filter -:foo
вместо -!foo и запустите "#file" вместо "$file",
для создания унифицированных пакетных файлов .sh для Windows и Linux.
-upat2 то же, что и -upat, но также поддерживает подстановочный знак % вместо *
вы также можете установить это с помощью переменной среды, например:
установить SFK_CONFIG=upat2
-noesckey отключить остановку клавишей escape. (только окна)

параметры ввода файла
-nosub или -norec не включает подкаталоги (подпапки).
обработка поддиректорий ПО УМОЛЧАНИЮ для большинства команд,
поэтому вы должны указать -nosub, чтобы отключить его.
-withsub включает подкаталоги. ПО УМОЛЧАНИЮ для большинства команд.
-maxsub=n включает содержимое до n уровней подкаталогов.
-withdirs включает в обработку имена (под) папок.
-justdirs использует для обработки только имена (под) папок.
-nofollow или -nfo не следует символическим ссылкам на каталоги.
эта опция может НЕ работать со старыми версиями Linux,
особенно тем, кому нужна бинарная версия sfk "lib5".
-textfiles обрабатывают только текстовые файлы, а не двоичные файлы. - текст тот же,
но это может помешать параметрам command-local -text.
при обнаружении текста/бинарных файлов проверяются только первые 4 килобайта файла.
-binfiles обрабатывают только бинарные файлы. -bin то же самое, но это может
вмешиваться в локальную опцию -bin некоторой команды.
-hidden включает скрытые и системные файлы.
-nohidden исключить скрытые и системные файлы.
-minsize=s выбирать только файлы >= размера, например 10b или 100k
-maxsize=s выбирать только файлы <= размера, например 10 м или 4 г
b=байты k=кбайты m=мегабайты g=гигабайты=10^9 байтов
K=2^10 байт M=2^20 байт G=2^30 байт
-sincedir или -sincedif/add/chg: сравнить дерево каталогов с
дерево ссылок, обрабатывать только измененные или добавленные файлы.
подробности см. в "списке sfk".
-так как обрабатывать только файлы, измененные в или после предоставленного
дата/время. "список sfk" для деталей.
-before обрабатывать только файлы, измененные до этой даты/времени.
-flist fn или "-fl fn" читает список имен файлов из файла fn.
-tomake .ext выбирать только файлы, которые не имеют или более старые,
аналогичный файл с расширением .ext в той же папке.
-tomake outdir\$base.ext выбирать только те файлы, которые не имеют или
более старый файл-аналог в outdir с расширением .ext.
см. «sfk run», например: преобразование .wav в .mp3
-wchar активировать ЭКСПЕРИМЕНТАЛЬНУЮ декодировку utf-16 (ucs-2, wide char),
разрешение sfk find или filter для поиска текста в файлах utf-16.
не следует использовать при (пере)записи файлов. получить больше информации
набрав «sfk help unicode».

параметры ввода и фильтрации текста
-case активировать сравнение текста с учетом регистра с некоторыми командами.
большинство команд обработки текста по умолчанию нечувствительны к регистру.
сравнение имен файлов всегда нечувствительно к регистру.
подробнее см.: sfk help nocase
-spat активирует интерпретацию косой черты:
\t=TAB \q=" \r=CR \n=LF \\=\ \xnn=любой символ с шестнадцатеричным кодом nn
с некоторыми командами, такими как replace, filter -form и -replace.
-spats строгие шаблоны косой черты, показывать ошибку на неправильных шаблонах, таких как \a.
-literal или -lit отключает интерпретацию подстановочных знаков * и ?
и шаблоны косой черты, если они были активированы ранее.
-nospat отключает только шаблоны косой черты.
-deacc использовать текстовый поиск без учета диакритических знаков и выбор имени файла,
т.е. a == a_accent или o == o_umlaut. может работать только с
некоторые кодовые страницы Windows, но не с текстом utf-8.
-binallchars с преобразованием двоичного кода в текст, включая все печатные
символы, такие как акценты или не латинские.

параметры сети
-header x или -head добавляет пользовательский заголовок x в http-запросы, например
-header "Принять-язык: de,en-US;q=0.7,en;q=0.3"
можно указать несколько строк заголовка. заголовки по умолчанию
с тем же именем заменены.

параметры информации о пользователе
-verbose печатать дополнительную информацию во время выполнения команды.
полезно, если команда не работает должным образом.
только некоторые команды поддерживают -verbose. попробуйте также -verbose=2.
- Больше вывода паузы в зависимости от высоты терминала.
-более 50 страниц с 50 строками на странице.
-more является экспериментальным и может не учитываться точно.
-quiet уменьшить вывод некоторых команд. например, команда find будет
не отображать информацию о статусе «сканирования» при поиске файлов.
-quiet=2 еще больше уменьшить вывод некоторых команд.
-nowarn и -noerr, -nonote отключают предупреждения, сообщения об ошибках и примечания.
-nohead no не отображать информацию заголовка/трейлера для некоторых команд: запуск cmd
не скажет «имитация», даже если он находится в режиме симуляции.
-tracechain подробно рассказать, как выполняется цепочка команд.
-tracel дает подробную информацию о том, почему каталоги и файлы были
выбраны или исключены. -tracedirs перечисляет только каталоги,
-tracefiles перечисляет только файлы.
-debug печатать дополнительную информацию о потоке программы для отслеживания ошибок.
также активирует -memcheck под Windows.
-memcheck проверять список памяти в конце каждой команды
для обнаружения перезаписей. снижает производительность.
-exectime сообщает время выполнения команды в конце программы.
-headers выводить заголовки http с командами, обращающимися в сеть.

параметры вывода файла
-tofile x указать одно имя выходного файла, которое принимается как есть
и не проверяется на наличие шаблонов $.
-в маске указать куда записывать выходные файлы с некоторыми командами.
маска поддерживает $file, $path, $relpath, $base, $ext и другие,
как -to outdir\$base-modified.$ext
скажите "sfk run" для списка возможных ключевых слов.
-tmpdir x установить каталог x в качестве каталога временных файлов. по умолчанию
использовать путь, указанный переменной env TEMP или TMP.
-showtmp подробно указать, какие временные файлы создаются.
-keeptmp не удалять временные файлы, если это возможно.

параметры вывода терминала
-nocol отключить весь цветной вывод. важно, если ваша оболочка имеет
цвет фона, несовместимый с цветовой схемой по умолчанию,
или (в Linux), если текст вывода sfk должен быть обработан
далее через конвейерную обработку и должен быть удален из
управляющие последовательности цветов.
-col включить цветной вывод. "sfk help colors" для получения дополнительной информации.
-nocconv при выводе на консоль Windows, sfk пытается
для преобразования символов умляут и ударения для их отображения
правильно с кодовой страницей 850. Установите -nocconv, чтобы отключить это.
всякий раз, когда вывод перенаправляется в файл, преобразование не выполняется.
-cconv принудительное преобразование кодовой страницы: если вывод команды перенаправляется
в файл, преобразование кодовой страницы по умолчанию отключено.
используйте эту опцию для активации, например, при постобработке
вывод запуска sfk, который создает списки имен файлов.
-html дамп текста справки sfk (управление цветом) в формате html.
-html нужно вводить сразу после "sfk".
-htmlpage то же самое, но включает заголовок для просмотра в браузере.

код возврата и параметры ошибки
-showrc печатать код возврата sfk в конце команды или программы.
может ничего не печатать в случае фатальных ошибок,
как неправильный синтаксис (обычно rc 9).
-justrc позволяет некоторым командам ничего не печатать и просто создавать rc.
-exterr в случае ошибок, связанных с операционной системой, таких как доступ к файлам,
печатает расширенную информацию об ошибке, если она доступна.
-waitonerr ждать ввода данных пользователем при каждой ошибке.
-waitonend ждать ввода данных пользователем в конце программы.
-stoponerr остановить обработку дерева каталогов при первом нечитаемом файле.
по умолчанию обрабатывать как можно больше файлов, пропуская
нечитаемые файлы и каталоги.
-rcfromerr некоторые команды, такие как filter, find, hexfind сообщают оболочке rc
что что-то нашлось. по умолчанию пропущены такие ошибки, как
нечитаемые файлы НЕ изменяют этот rc. с -rcfromerr,
пропущенные ошибки переопределяют полученную оболочку rc.
-echoonerr вывести всю команду на стандартный вывод при возникновении ошибки.
см. также настройку SFK_CONFIG "echoonstart" ниже.
чтобы поэкспериментировать с указанными выше параметрами, попробуйте "sfk errortest".

разнообразные варианты
-arc читать содержимое известных архивов zip, tar.gz и tar.bz2
как можно глубже, включая вложенные архивы.
общеизвестные архивы должны иметь одно из следующих расширений:
.zip .jar .ear .war .aar .xpi .tar .tar.gz .tar.bz2 .tgz
.gz .bz2 .docx .xlsx .dotx .pptx .odt .ods .otg .odp .odg
.dotm .docb .xlsm .xltx .xltm .pptm .potx .potm .ppam .ppsx
.ppsm .sldx .sldm .odc .odf .odi .odm .ott .ots .otp .jmod
чтобы включить дополнительные расширения, читайте ниже о SFK_ZIP_EXT.
этот двоичный файл (SFK Base/XD) может читать только первые 1000 байтов
каждой архивной записи. перечень содержимого не ограничен.
введите "sfk help xe" для получения подробной информации и ограничений.
-xarc читать содержимое любого zip-файла, независимо от расширения файла,
и файлы tar.gz и tar.bz2. читает первые байты каждого
файл и поэтому будет работать медленнее, чем -arc.
-qarc быстро читать архивы верхнего уровня, но не вложенные.
-weblimit=n изменить лимит загрузки веб-доступа на n мегабайт, с
такие функции, как sfk web, filter, xex. по умолчанию 100 мб.
вы также можете установить SFK_CONFIG=weblimit:30
-webtimeout=n время ожидания веб-доступа в миллисекундах. по умолчанию 10000.
вы также можете установить SFK_CONFIG=webtimeout:3000
-webuser=u вместе с -webpw=p установить базовую аутентификацию HTTP
с разнообразными командами, поддерживающими http://веб-доступ.
-memlimit=n установить лимит кэшируемой памяти на n мегабайт (по умолчанию = 300).
используется, если функции необходимо загрузить целые файлы в память.
если zip и т.п. архив обрабатывается очень медленно, это может быть вызвано
переполнение кеша. попробуйте тогда увеличить -memlimit.
если вы считаете, что sfk использует слишком много памяти при обработке файлов,
попробуйте уменьшить -memlimit (значения ниже 200 не рекомендуются).
вы также можете установить SFK_CONFIG (см. конец этого текста).
-cachestat сообщить объем памяти, используемый кешем архивных файлов.
-nocache отключить кеш диска (для сетевых файлов).
-noipex отключить автоматическое расширение IP некоторыми командами.
-noop ничего не делать (нет операции). иногда полезно в качестве дополнения.

командная локальная или глобальная область действия:

в цепочке команд многие параметры действуют только локально
с командой, где они указаны, например, в

sfk filt x.txt -case -высокий красный FooCase +filt -высокий синий TheBar

"-case" действителен только для первой команды фильтра.
но следующие параметры также могут использоваться глобально, если они указаны
сразу после "sfk":

-nohead -noinfo -nofile -case -literal -spat

например, в

sfk -case filt x.txt -высокий красный FooCase +filt -высокий синий TheBar

"-case" действителен для ВСЕХ команд в цепочке команд.

конфигурация среды:

установить SFK_CONFIG = столбцы: n, возраст активного файла: n, лимит памяти: n,...
столбцы:
sfk (для Windows) пытается автоматически определить нет. консольных колонн,
но вы также можете установить это значение через этот параметр конфигурации.
возраст активного файла: n
некоторые функции должны сообщать, является ли файл «недавно редактируемым» или, скорее,
старый и неактивный. по умолчанию считаются файлы старше 30 дней.
не активен. переконфигурировать нет. порог дней здесь.
лимит памяти:
установить лимит памяти на n мегабайт.
эхонстарт:
вывести всю команду sfk при запуске на stderr.
эхоонерр:
вывести всю команду sfk при ошибках на stderr.
tmpdir:путь
установить папку для временных файлов, используемых некоторыми командами.
например, установите SFK_CONFIG=tmpdir:d:\tmp,memlimit:500

установить SFK_ZIP_EXT=".foo .bar .myext"
установить дополнительные пользовательские расширения zip-файлов. в этом примере
файлы, оканчивающиеся на .foo, .bar или .myext, также обрабатываются как zip-файлы.
список расширений по умолчанию см. выше в параметре -arc.