36.11 Информация о системе

: computer ()

: c = computer ()

: [c, maxsize] = computer ()

: [c, maxsize, endian] = computer ()

: arch = computer ("arch")

Выведите или верните строку вида cpu-vendor-os, которая определяет тип компьютера, на котором запущена Octave.

Если вызывается с аргументом возврата, значение возвращается вместо вывода. Например:

computer ()
   -| x86_64-pc-linux-gnu

mycomp = computer ()
   ⇒ mycomp = x86_64-pc-linux-gnu

Если требуется два аргумента возврата, также возвращается максимальное количество элементов для массива. Это зависит от того, скомпилирована ли Octave с 32-разрядными или 64-разрядными индексными векторами.

Если требуется три аргумента возврата, также возвращается порядок байтов текущей системы как символ ("B" для big-endian или "L" для little-endian).

Если указан аргумент "arch", верните строку, указывающую архитектуру компьютера, на котором запущена Octave.

См. также: isunix, ismac, ispc.

: [uts, err, msg] = uname ()

Возвращает информацию о системе в структуре.

Например:

uname ()
   ⇒ {
         sysname = x86_64
         nodename = segfault
         release = 2.6.15-1-amd64-k8-smp
         version = Linux
         machine = #2 SMP Thu Feb 23 04:57:49 UTC 2006
      }

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

: nproc ()

: nproc (query)

Возвращает текущее количество доступных процессоров.

Если вызывается с необязательным аргументом query, изменяется способ подсчёта процессоров следующим образом:

all

общее количество процессоров.

current

процессоры, доступные текущему процессу.

overridable

то же, что и current, но переопределяемое через переменную среды OMP_NUM_THREADS.

: ispc ()

Возвращает значение true, если Octave запущена на системе Windows, и false в противном случае.

См. также: isunix, ismac.

: isunix ()

Возвращает значение true, если Octave запущена на системе типа Unix, и false в противном случае.

См. также: ismac, ispc.

: ismac ()

Возвращает значение true, если Octave запущена на системе Mac OS X, и false в противном случае.

См. также: isunix, ispc.

: isieee ()

Возвращает значение true, если ваш компьютер заявляет о соответствии стандарту IEEE для вычислений с плавающей запятой.

Никаких реальных тестов не выполняется.

: isdeployed ()

Возвращает значение true, если текущая программа скомпилирована и запущена отдельно от интерпретатора Octave, и false, если она запущена в интерпретаторе Octave.

В настоящее время эта функция всегда возвращает false в Octave.

: isstudent ()

Возвращает значение true, если выполняется в учебной версии MATLAB.

isstudent всегда возвращает false в Octave.

См. также: false.

: OCTAVE_HOME ()

Возвращает имя каталога установки Octave верхнего уровня. OCTAVE_HOME соответствует конфигурационной переменной prefix.

См. также: EXEC_PATH, IMAGE_PATH, OCTAVE_EXEC_HOME.

: OCTAVE_EXEC_HOME ()

Возвращает имя каталога установки Octave верхнего уровня для файлов, зависящих от архитектуры. Если не указано отдельно, значение равно OCTAVE_HOME. OCTAVE_EXEC_HOME соответствует конфигурационной переменной exec_prefix.

См. также: EXEC_PATH, IMAGE_PATH, OCTAVE_HOME.

: matlabroot ()

Возвращает имя каталога установки Octave верхнего уровня.

Это псевдоним функции OCTAVE_HOME для совместимости.

См. также: OCTAVE_HOME.

: OCTAVE_VERSION ()

Возвращает номер версии Octave в виде строки.

См. также: ver, version.

: v = version ()

: [v, d] = version ()

: v = version (feature)

Получение информации о версии Octave.

Если вызывается без входного аргумента, первое возвращаемое значение v представляет собой номер версии Octave в виде строки. Второе возвращаемое значение d содержит дату выпуска в виде строки.

Следующие параметры могут быть переданы для feature:

"-date"

для даты выпуска текущей сборки,

"-description"

для описания выпуска (всегда пустая строка),

"-release"

для имени текущей сборки (всегда пустая строка),

"-java"

для информации о версии Java VM,

"-fftw"

для информации о версии связанной библиотеки FFTW,

"-blas"

для информации о версии связанной библиотеки BLAS,

"-lapack"

для информации о версии связанной библиотеки LAPACK.

"-hgid"

идентификатор mercurial используемых источников для сборки Octave.

Информация, возвращённая для параметров "-blas" и "-lapack", может быть ненадёжной. Она может указывать на библиотеку, связанную при сборке Octave, а не на ту, которая используется в настоящее время.

Вариант без входных и выходных аргументов является псевдонимом функции OCTAVE_VERSION для совместимости.

См. также: OCTAVE_VERSION, ver.

: ver

: ver Octave

: ver package

: v = ver (…)

Выводит заголовок, содержащий текущий номер версии Octave, строку лицензии и операционную систему. За заголовком следует список установленных пакетов, версий и каталогов установки.

Используйте имя пакета package или Octave для запроса конкретного компонента.

При вызове с аргументом возврата верните вектор структур, описывающих Octave и каждый установленный пакет. Каждая структура содержит следующие поля.

Name

Имя пакета.

Version

Версия пакета.

Release

Выпуск пакета (в настоящее время не используется, по умолчанию []).

Date

Дата выпуска версии.

См. также: version, usejava, pkg.

: compare_versions (v1, v2, operator)

Сравнение двух строк версий с использованием указанного operator.

Эта функция предполагает, что версии v1 и v2 — это произвольные длинные строки, состоящие из числовых и точечных символов, за которыми могут следовать произвольные строки (например, "1.2.3", "0.3", "0.1.2+", или "1.2.3.4-test1").

Версия сначала разбивается на числовые и символьные части, а затем части дополняются до одинаковой длины (например, "1.1" будет дополнена до "1.1.0" при сравнении с "1.1.1", и отдельно, символьные части строк дополняются нулями).

Оператор может быть любым логическим оператором из набора:

• "==" равно
• "<" меньше
• "<=" меньше или равно
• ">" больше
• ">=" больше или равно
• "!=", "~=" не равно

Обратите внимание, что версия "1.1-test2" будет сравниваться как большая, чем "1.1-test10". Кроме того, поскольку сначала сравнивается числовая часть, "a" сравнивается как меньше, чем "1a", потому что вторая строка начинается с числовой части, даже если double ("a") больше, чем double ("1")..

: verLessThan (package, version)

Возвращает true, если установленная версия пакета меньше version.

package — имя пакета для проверки. Используйте "Octave" в качестве package, чтобы проверить версию Octave.

version — версия для сравнения. Версия — строка в формате, принятом compare_versions: произвольная строка, состоящая из числовых символов и точек, возможно, за которой следует произвольная строка (например, "1.2.3", "0.3", "0.1.2+", или "1.2.3.4-test1").

Примеры:

tf = verLessThan ("Octave", "5")
⇒ tf = 0

tf = verLessThan ("io", "2.4.12")
⇒ ...

if (! verLessThan ("Octave", "5"))
  ## ... use new Octave 5 features ...
endif

См. также: compare_versions, version, ver, pkg.

: license

: license inuse

: license inuse feature

: license ("inuse")

: retval = license ("inuse")

: retval = license ("test", feature)

: retval = license ("checkout", feature)

: [retval, errmsg] = license ("checkout", feature)

Получение информации о лицензии для Octave и пакетов Octave.

GNU Octave — это свободное программное обеспечение, распространяемое по лицензии GNU General Public License (GPL), и менеджер лицензий не имеет смысла. Эта функция предоставляется только для совместимости с MATLAB.

При вызове без дополнительных входных аргументов она возвращает лицензию Octave, в противном случае первый входной параметр определяет режим работы и должен быть одной из следующих строк: inuse, test, и checkout. Дополнительный аргумент feature может быть "octave" (core), или пакетом Octave.

"inuse"

Возвращает список загруженных функций, то есть octave и список загруженных пакетов. Если запрашивается вывод, возвращается массив структур с полями "feature", и "user".

"test"

Возвращает true, если указанная функция feature установлена, в противном случае — false.

Дополнительный третий аргумент "enable" или "disable" принимается, но игнорируется.

"checkout"

Возвращает true, если указанная функция feature установлена, в противном случае — false. Дополнительный второй вывод будет содержать сообщение об ошибке, если пакет не установлен.

См. также: pkg, ver, version.

: getrusage ()

Возвращает структуру, содержащую ряд статистических данных о текущем процессе Octave.

Не все поля доступны на всех системах. Если получить статистику времени работы процессора невозможно, слоты времени работы процессора устанавливаются в ноль. Другие отсутствующие данные заменяются NaN. Список возможных полей:

idrss

Размер неразделяемых данных.

inblock

Количество операций ввода блоками.

isrss

Размер неразделяемого стека.

ixrss

Размер разделяемой памяти.

majflt

Количество основных страниц ошибок.

maxrss

Максимальный размер данных.

minflt

Количество второстепенных страниц ошибок.

msgrcv

Количество полученных сообщений.

msgsnd

Количество отправленных сообщений.

nivcsw

Количество вынужденных переключений контекста.

nsignals

Количество полученных сигналов.

nswap

Количество обменов.

nvcsw

Количество добровольных переключений контекста.

oublock

Количество операций вывода блоками.

stime

Структура, содержащая системное время, затраченное на выполнение процессором. Структура имеет элементы sec (секунды) usec (микросекунды).

utime

Структура, содержащая время работы процессора пользователя. Структура имеет элементы sec (секунды) usec (микросекунды).

: value = winqueryreg (rootkey, subkey, valuename)

: value = winqueryreg (rootkey, subkey)

: names = winqueryreg ("name", rootkey, subkey)

Запрос имен или значений из реестра Windows.

В Windows возвращает значение ключа реестра subkey из корневого ключа rootkey. Можно указать имя запрашиваемого значения реестра с помощью необязательного аргумента valuename. В противном случае, если вызывается с двумя аргументами или valuename пустое, возвращается значение по умолчанию subkey. Если значение реестра типа "REG_DWORD" , то value имеет класс int32. Если значение типа "REG_SZ" или "REG_EXPAND_SZ", возвращается строка.

Если первый аргумент — "name", возвращается ячейка строк с именами значений в этом ключе.

Переменная rootkey должна быть строкой с допустимым идентификатором корневого ключа:

HKCR

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKCU

HKEY_CURRENT_USER

HKLM

HKEY_LOCAL_MACHINE

HKU

HKEY_USERS

HKEY_PERFORMANCE_DATA

Примеры:

Получить список имен значений в ключе 'HKCU\Environment':

valuenames = winqueryreg ("name", "HKEY_CURRENT_USER", ...
                          "Environment");

Для каждого valuenames отобразить значение:

for k = 1:numel (valuenames)
  val = winqueryreg ("HKEY_CURRENT_USER", "Environment", ...
                     valuenames{k});
  str = sprintf ("%s = %s", valuenames{k}, num2str (val));
  disp (str);
endfor

На платформах, отличных от Windows, эта функция завершается ошибкой.