mbuild

Компиляция и связывание исходных файлов с общими библиотеками, созданными MATLAB

Синтаксис

mbuild [option1 ... optionN] sourcefile1 [... sourcefileN]
   [objectfile1 ... objectfileN] [libraryfile1 ... libraryfileN]

Описание

mbuild компилирует и связывает написанный пользователем код C или C++ с общими библиотеками, созданными MATLAB ® .

Некоторые из этих вариантов (-f, -g, и -v) доступны на mcc и передаются вместе с mbuild. Другие могут быть переданы с помощью -M опция для mcc. Для получения подробной информации о -M , см. mcc справочная страница.

Поддерживаемые типы исходных файлов

Поддерживаются следующие типы исходных файлов:

.c
.cpp

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

Варианты

В этой таблице приведен набор mbuild варианты. Если платформа не указана, эта опция доступна в UNIX ® и ^Windows ®.

Выбор	Описание
`@<rspfile>`	(только для Windows) Включить содержимое текстового файла `<rspfile>` в качестве аргументов командной строки для `mbuild`.
`-c`	Только компиляция. Создает только файл объекта.
`-D<name>`	Определите имя символа для препроцессора C. Эквивалентно `#define <name>` директива в источнике.
`-D<name>=<value>`	Определите имя и значение символа для препроцессора C. Эквивалентно `#define <name> <value>` директива в источнике.
`-f <optionsfile>`	Укажите расположение и имя файла параметров для использования. Переопределяет `mbuild` механизм поиска файлов опций по умолчанию.
`-g`	Создайте исполняемый файл, содержащий дополнительную символическую информацию для использования в отладке. Этот параметр отключает `mbuild` поведение по умолчанию при оптимизации кода построенного объекта (см. `-O` опция).
`-h[elp]`	Печать справки для `mbuild`.
`-I<pathname>`	Добавить `<pathname>` в список папок для поиска `#include` файлы.
`-l<name>`	Связь с библиотекой объектов. В системах Windows `<name>` расширяется до `<name>.lib` или `lib<name>.lib` и в системах UNIX, `lib<name>.so` или `lib<name>.dylib`. Не добавляйте пробел после этого коммутатора. Примечание При связывании с библиотекой важно сначала указать путь (с помощью `-I<pathname>`, например).
`-L<folder>`	Добавить `<folder>` в список папок для поиска библиотек, указанных с помощью `-l` вариант. В системах UNIX необходимо также задать пути к библиотекам времени выполнения. Не добавляйте пробел после этого коммутатора.
`-n`	Режим выполнения отсутствует. Распечатайте все команды, которые `mbuild` в противном случае был бы выполнен, но фактически не выполнил бы ни один из них.
`-O`	Оптимизируйте код объекта. Оптимизация включена по умолчанию и включена в командной строке. Если `-g` опция появляется без `-O` опция, оптимизация отключена.
`-outdir <dirname>`	Поместить все выходные файлы в папку `<dirname>`.
`-output <resultname>`	Создание исполняемого файла с именем `<resultname>`. Автоматически добавляется соответствующее исполняемое расширение. Переопределяет `mbuild` механизм именования исполняемых файлов по умолчанию.
`-setup`	В интерактивном режиме укажите файл параметров компилятора C/C + +, который будет использоваться по умолчанию для будущих вызовов `mbuild` поместив его в папку профиля пользователя (возвращенную `prefdir` команда). Если этот параметр задан, другие входные данные командной строки не принимаются.
`-setup -client mbuild_com`	В интерактивном режиме укажите файл параметров компилятора COM, который будет использоваться по умолчанию для будущих вызовов `mbuild` поместив его в папку профиля пользователя (возвращенную `prefdir` команда). Если этот параметр задан, другие входные данные командной строки не принимаются.
`-U<name>`	Удалить любое исходное определение символа препроцессора C `<name>`. (Обратная `-D` вариант.)
`-v`	Подробный режим. Распечатайте значения важных внутренних переменных после обработки файла параметров и рассмотрения всех аргументов командной строки. Печатает каждый этап компиляции и завершающий этап связи, который был полностью оценен.
`<name>=<value>`	Добавление или переопределение переменной файла параметров для переменной `<name>`. Этот параметр обрабатывается после обработки файла параметров и рассмотрения всех аргументов командной строки. Возможно, потребуется использовать синтаксис кавычек оболочки для защиты символов, например пробелов, которые имеют значение в синтаксисе оболочки. В Windows используются двойные кавычки (например, `COMPFLAGS="opt1 opt2"`) и в UNIX используются одиночные кавычки (например, `CFLAGS='opt1 opt2'`). Обычно эта опция используется для дополнения уже определенной переменной. Для этого обратитесь к переменной путем добавления `$` (например, `COMPFLAGS="$COMPFLAGS opt2"` в Windows или `CFLAGS='$CFLAGS opt2'` в оболочке UNIX). Для компилятора MinGW-w64, который основан на gcc/g + +, используйте одинарные кавычки (`'`).

Примеры

Чтобы изменить компилятор C/C + + по умолчанию для использования с SDK™ компилятора MATLAB, используйте

mbuild -setup

Компиляция и связывание внешней программы C foo.c против libfoo, использовать

mbuild foo.c -L. -lfoo (on UNIX)
mbuild foo.c libfoo.lib (on Windows)

Это предполагает и то, и другое foo.c и библиотека, созданная выше, находится в текущей рабочей папке.

Представлен до R2006a

Документация