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" для большого порядка байтов или "L" для малого порядка байтов).

Если указан аргумент "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.

Вариант без входного и выходного аргументов — это псевдоним для функции 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").

license

используемая лицензия

функция используемой лицензии

лицензия ("используемая")

retval = лицензия ("используемая")

retval = лицензия ("тест", функция)

retval = лицензия ("получение", функция)

[retval, errmsg] = лицензия ("получение", функция)

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

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

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

"inuse"

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

"test"

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

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

"checkout"

Возвращает true, если указанная функция установлена, в противном случае — 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, эта функция завершается ошибкой.