Далее: Утилиты архивирования файлов, Предыдущее: Утилиты времени, Вверх: Системные утилиты [Содержание][Индекс]

36.2 Утилиты файловой системы ¶

Octave включает в себя множество служебных функций для копирования, перемещения, переименования и удаления файлов; для создания, чтения и удаления каталогов; для получения информации о состоянии файлов; и для работы с именами файлов и путей.

: movefile f1 ¶

: movefile f1 f2 ¶

: movefile f1 f2 f ¶

: movefile (f1) ¶

: movefile (f1, f2) ¶

: movefile (f1, f2, 'f') ¶

: [status] = movefile (…) ¶

: [status, msg] = movefile (…) ¶

: [status, msg, msgid] = movefile (…) ¶

Переместить исходный файл или каталог f1 в назначение f2.

Имя f1 может содержать шаблоны поиска с использованием подстановочных знаков или быть ячейкой массива строк. Если f1 расширяется до нескольких имен файлов, f2 должно быть каталогом.

Если не указано назначение f2, то назначением является текущий рабочий каталог. Если f2 является именем файла, то f1 переименовывается в f2.

Если флаг принуждения 'f' задан, любые существующие файлы будут перезаписаны без запроса.

В случае успеха, status имеет логическое значение 1, а msg, msgid являются пустыми строками (""). В противном случае, status имеет логическое значение 0, msg содержит зависящее от системы сообщение об ошибке, а msgid содержит уникальный идентификатор сообщения. Обратите внимание, что код состояния является точно противоположным коду команды system.

См. также: rename, copyfile, unlink, delete, glob.

: rename old new ¶

: [status, msg] = rename (old, new) ¶

Изменить имя файла old на new.

В случае успеха, status равен 0, а msg является пустой строкой. В противном случае, status равен -1, а msg содержит зависящее от системы сообщение об ошибке.

См. также: movefile, copyfile, ls, dir.

: copyfile f1 f2 ¶

: copyfile f1 f2 f ¶

: copyfile (f1, f2) ¶

: copyfile (f1, f2, 'f') ¶

: [status, msg, msgid] = copyfile (…) ¶

Скопировать исходный файл(ы) или каталог f1 в назначение f2.

Если флаг принуждения 'f' задан, любые существующие файлы будут перезаписаны без запроса.

См. также: movefile, rename, unlink, delete, glob.

: unlink (file) ¶

: [status, msg] = unlink (file) ¶

Удалить файл с именем file.

См. также: delete, rmdir.

: link old new ¶

: [status, msg] = link (old, new) ¶

Создать новую ссылку (также известную как жёсткая ссылка) на существующий файл.

См. также: symlink, unlink, readlink, lstat.

: symlink old new ¶

: [status, msg] = symlink (old, new) ¶

Создать символическую ссылку new, которая содержит строку old.

См. также: link, unlink, readlink, lstat.

: result = readlink symlink ¶

: [result, err, msg] = readlink (symlink) ¶

Прочитать значение символической ссылки symlink.

При успешном выполнении, result содержит содержимое символической ссылки symlink, err равно 0, а msg — пустая строка. В противном случае, err отлично от нуля, а msg содержит сообщение об ошибке, зависящее от системы.

См. также: lstat, symlink, link, unlink, delete.

: mkdir dirname ¶

: mkdir parent dirname ¶

: mkdir (dirname) ¶

: mkdir (parent, dirname) ¶

: [status, msg, msgid] = mkdir (…) ¶

Создать директорию с именем dirname в директории parent, создавая промежуточные директории при необходимости.

Если dirname — относительный путь и директория parent не указана, используется текущая рабочая директория.

При успешном выполнении, status имеет логическое значение 1, а msg и msgid — пустые строки (""). В противном случае, status имеет логическое значение 0, msg содержит сообщение об ошибке, зависящее от системы, а msgid содержит уникальный идентификатор сообщения. Обратите внимание, что код состояния является прямо противоположным коду команды system.

При создании директории права будут установлены на 0777 - UMASK.

См. также: rmdir, pwd, cd, umask.

: rmdir dir ¶

: rmdir (dir, "s") ¶

: [status, msg, msgid] = rmdir (…) ¶

Удалить директорию с именем dir.

Если второй необязательный параметр задан со значением "s", рекурсивно удаляются также все поддиректории.

См. также: mkdir, confirm_recursive_rmdir, pwd.

: val = confirm_recursive_rmdir () ¶

: old_val = confirm_recursive_rmdir (new_val) ¶

: old_val = confirm_recursive_rmdir (new_val, "local") ¶

Запрос или установка внутренней переменной, контролирующей, будет ли Octave запрашивать подтверждение перед рекурсивным удалением дерева директорий.

При вызове из функции с опцией "local", переменная изменяется локально для функции и любых вызываемых ею подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: rmdir.

: mkfifo (name, mode) ¶

: [status, msg] = mkfifo (name, mode) ¶

Создать специальный файл FIFO с именем name и режимом файла mode.

mode интерпретируется как восьмеричное число и подвергается обработке umask. Результирующий рассчитанный режим — mode - umask.

При успешном выполнении, status равно 0, а msg — пустая строка. В противном случае, status равно -1, а msg содержит сообщение об ошибке, зависящее от системы.

См. также: pipe, umask.

: oldmask = umask (mask) ¶

Установить маску разрешений для создания файлов.

Параметр mask — целое число, интерпретируемое как восьмеричное число.

При успешном выполнении, возвращает предыдущее значение маски (как целое число, интерпретируемое как восьмеричное число); в противном случае выводится сообщение об ошибке.

Маска разрешений — понятие UNIX, используемое при создании новых объектов в файловой системе, таких как файлы, директории или именованные FIFO. Объект, который необходимо создать, имеет базовые разрешения в восьмеричном числе mode, которые изменяются в соответствии с восьмеричным значением mask. Конечные разрешения для нового объекта — mode - mask.

См. также: fopen, mkdir, mkfifo.

: [info, err, msg] = stat (file) ¶

: [info, err, msg] = stat (fid) ¶

: [info, err, msg] = lstat (file) ¶

: [info, err, msg] = lstat (fid) ¶

Возвращает структуру info, содержащую следующую информацию о файле file или идентификаторе файла fid.

dev: Идентификатор устройства, содержащего запись о файле в каталоге.
ino: Номер файла.
mode: Режим файла в виде целого числа. Используйте функции S_ISREG, S_ISDIR, S_ISCHR, S_ISBLK, S_ISFIFO, S_ISLNK, или S_ISSOCK, чтобы извлечь информацию из этого значения.
modestr: Режим файла в виде строки из десяти букв или дефисов, как возвращает ls -l.
nlink: Количество ссылок.
uid: Идентификатор пользователя владельца файла.
gid: Идентификатор группы владельца файла.
rdev: Идентификатор устройства для блочных или символьных специальных файлов.
size: Размер в байтах.
atime: Время последнего доступа в том же формате, что и значения времени, возвращаемые функцией time. См. Утилиты работы со временем.
mtime: Время последней модификации в том же формате, что и значения времени, возвращаемые функцией time. См. Утилиты работы со временем.
ctime: Время последнего изменения статуса файла в том же формате, что и значения времени, возвращаемые функцией time. См. Утилиты работы со временем.
blksize: Размер блоков в файле.
blocks: Количество выделенных блоков для файла.

При успешном вызове err равно 0, а msg — пустая строка. Если файла не существует или произошла другая ошибка, info — пустая матрица, err равно −1, а msg содержит соответствующее сообщение об ошибке системы.

Если file — символическая ссылка, stat вернёт информацию об actual файле, на который указывает ссылка. Используйте lstat, если вам нужна информация о самой символической ссылке.

Например:

[info, err, msg] = stat ("/vmlinuz")
  ⇒ info =
     {
       atime = 855399756
       rdev = 0
       ctime = 847219094
       uid = 0
       size = 389218
       blksize = 4096
       mtime = 847219094
       gid = 6
       nlink = 1
       blocks = 768
       mode = -rw-r--r--
       modestr = -rw-r--r--
       ino = 9316
       dev = 2049
     }
  ⇒ err = 0
  ⇒ msg =

См. также: lstat, ls, dir, isfile, isfolder.

: tf = S_ISBLK (mode) ¶

Возвращает true, если mode соответствует блочному устройству.