dmcs - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

mcs - компілятор Mono C#

СИНТАКСИС

mcs [опція] [джерело-файли]

ОПИС

mcs — це компілятор Mono C#, реалізація специфікації мови ECMA-334.
Ви можете передати один або кілька параметрів для керування компілятором і набір вихідних файлів. Додатковий
параметри або аргументи можна надати у файлі відповідей. На файли відповідей посилається
додавання символу @ до назви файлу відповідей.

Команда mcs компілятор використовується для компіляції з останньою версією Mono Base Class Library і
повністю реалізує специфікації C# 1.0, 2.0, 3.0 і 4.0.

Для отримання додаткової інформації дивіться розділ про пакети.

Компілятор Mono C# приймає ті самі параметри командного рядка, що і компілятор Microsoft C#
робить. Ці параметри можуть починатися з косої риски або тире (/checked те саме, що -checked).
Крім того, підтримуються деякі параметри, подібні до GNU, які починаються з "--". Усі специфічні для MCS
прапори, які недоступні в компіляторі Microsoft C#, доступні лише з
Параметри в стилі GNU.

Вихідні файли C# мають закінчуватися розширенням ".cs". Потрібна компіляція вихідного коду C#
всі файли, які складають бібліотеку, модуль або виконуваний файл, які надаються командою
лінія. Немає підтримки часткової компіляції. Для досягнення переваги часткової
компіляції, ви повинні скомпілювати програми у власні збірки, а пізніше посилання
їх із прапорцем "-r".

Компілятор Mono C# створює зображення (файли .exe), які містять байтовий код CIL, який може бути
виконується будь-якою системою, яка реалізує віртуальну машину Common Language Infrastructure
наприклад, механізм виконання Microsoft .NET у Windows або механізм виконання Mono в Unix
системи. Виконувані файли не прив’язані до певного ЦП або операційної системи.

Компілятор Mono C# за замовчуванням посилається лише на три збірки: mscorlib.dll, System.dll
і System.Xml.dll. Якщо ви хочете посилатися на додаткові бібліотеки, ви повинні вказати вручну
за допомогою параметра командного рядка -pkg: або параметра командного рядка -r:. Як варіант, якщо
якщо ви хочете отримати всі системні бібліотеки, ви можете використовувати командний рядок -pkg:dotnet
варіант.

ВАРІАНТИ

--про
Відображає інформацію про компілятор Mono C#

--addmodule:MODULE1[,MODULE2]
Включає вказані модулі в отриману збірку. Модулі створюються за допомогою
виклик компілятора з опцією -target:module

- перевірено, -перевірено+
Встановлює режим компіляції за замовчуванням на `checked'. Це робить усі математичні операції
позначено (за замовчуванням знято).

-перевірено-
Встановлює режим компіляції за замовчуванням на `unchecked'. Це робить всю математику
операції знято (це за замовчуванням).

-clscheck-, -clscheck+
Вимикає або вмикає перевірки специфікації загальної мови (CLS) (вона увімкнена
за замовчуванням).

Специфікація загальної мови (CLS) визначає взаємодіючу підмножину типів як
а також конвенції, яких повинні дотримуватися компілятори (виробники CLS) і розробники
надавати код іншим мовам програмування (споживачам CLS).

-кодова сторінка: ідентифікатор
Вказує кодову сторінку, яка використовується для обробки вхідних файлів із того моменту, на якому вона є
зазначено на. За замовчуванням файли будуть оброблятися в залежності від середовища
рідна кодова сторінка. Компілятор також автоматично виявить файли Unicode, які
мають на початку вбудовану позначку байта.

Інші популярні кодування: 28591 (Latin1), 1252 (iso-8859-1) і 65001 (UTF-8).

MCS підтримує кілька скорочень: "utf8" можна використовувати для вказівки utf-8 замість
використання cryptic 65001 і "скидання" відновлює автоматичну обробку кодових сторінок.
Ці скорочення недоступні в компіляторі Microsoft.

-define:SYMLIST, -d:СПИСОК СИМВОЛІВ
Визначає символ у списку, розділених крапкою з комою SYMLIST SYMBOL. Це
може бути перевірена у вихідному коді препроцесором або може бути використана методами
які були позначені атрибутом Conditional.

-відлагоджувати, -debug+
Згенерувати налагоджувальну інформацію. Щоб отримати трасування стека з інформацією про налагодження,
вам потрібно викликати моно середню виконання з прапором `--debug'. Налагодження
інформація зберігається у файлі MDB, розташованому в тій самій вихідній папці, що і створена
збірка

-відлагоджувати-
Не генеруйте налагоджувальну інформацію.

-знак затримки+
Лише вставте відкритий ключ strongname в збірку. Фактичне підписання має бути
зроблено на пізнішому етапі за допомогою інструменту SN. Це корисно для захисту приватного ключа
під час розробки. Зауважте, що відкладене підписання можна зробити лише за допомогою ключа сильного імені
файл (не контейнер ключів). Опція еквівалентна включення [збірки:
AssemblyDelaySign (true)] у вашому вихідному коді. Опція компілятора має пріоритет
над атрибутами.

-знак затримки-
За замовчуванням. Strongname (підпишіть) збірку за допомогою ключового файлу сильного імені (або
контейнер). Опція еквівалентна включенню [assembly: AssemblyDelaySign
(false)] у вашому вихідному коді. Параметр компілятора має пріоритет над атрибутами.

-doc: ФАЙЛ
Витягує документацію C#/XML з вихідного коду та зберігає в наведеному
ФАЙЛ.

-повідомити про помилку
Цей прапор ігнорується компілятором Mono C# і присутній лише для того, щоб дозволити використовувати MCS
використовується як заміна CSC для msbuild/xbuild.

-- смертельно
Це використовується для налагодження компілятора. Це змушує випромінювання помилки генерувати an
виняток, який може бути перехоплений налагоджувачем.

-filealign
Цей прапор ігнорується компілятором Mono C# і присутній лише для того, щоб дозволити використовувати MCS
використовується як заміна CSC для msbuild/xbuild.

-повні шляхи
Будь-яка помилка вихідного коду або попередження, видане компілятором, містить лише ім’я файлу by
за замовчуванням. Цей параметр змушує компілятор замість цього видавати абсолютний шлях до файлу.

-ключовий файл:KEYFILE
Сильне ім'я (підпис) вихідної збірки за допомогою пари ключів, наявної у вказаному
ключовий файл із міцним ім'ям (snk). Повна пара ключів потрібна за замовчуванням (або під час використання
затримка-). Файл, що містить лише відкритий ключ, можна використовувати з delaysign+. The
опція еквівалентна включенню [assembly: AssemblyKeyFile ("KEYFILE")] у ваш
вихідний код. Параметр компілятора має пріоритет над атрибутами.

- keycontainer: КОНТЕЙНЕР
Сильне ім'я (підпис) вихідної збірки за допомогою пари ключів, наявної у вказаному
контейнер. Зауважте, що delaysign+ ігнорується при використанні контейнерів ключів. Варіант такий
еквівалентно включенню [assembly: AssemblyKeyName ("CONTAINER")] у ваше джерело
код. Параметр компілятора має пріоритет над атрибутами.

-langversion:ТЕКСТ
Параметр визначає версію мови, яку потрібно використовувати. Набір функцій є
різні в кожній версії C#. Цей перемикач можна використовувати, щоб примусити компілятор до
допускати лише підмножину функцій. Можливі значення:

дефолт
Доручіть компілятору використовувати останню версію. Еквівалент – опустити
switch (наразі за замовчуванням це специфікація мови C# 4.0).

ISO-1 Обмежте компілятором використання лише перших стандартизованих функцій ISO. Використання
такі функції, як генерики, статичні класи, анонімні методи призведуть до
помилка

ISO-2 Обмежте компілятором використання лише других стандартизованих функцій ISO. Це
дозволяє використовувати генерики, статичні класи, ітератори та анонімні методи
наприклад.

3 Обмежте компілятором використання лише функцій, доступних у C# 3.0 (a
наднабір ISO-1 і ISO-2).

4 Обмежте компілятором використання лише функцій, доступних у C# 4.0
специфікація.

експериментальний
Вмикає нестабільні функції з майбутніх версій мови.

Зверніть увагу, що цей прапор обмежує лише мовні функції, доступні для
програміст. Варіантом виготовлених вузлів можна керувати за допомогою SDK варіант.

-lib:СПИСОК ШЛЯХІВ
Кожен шлях, зазначений у списку, розділеному комами, спрямовуватиме компілятор на пошук
для бібліотек у вказаному шляху.

-L PATH
Наказує компілятору шукати бібліотеки за вказаним шляхом. Кілька шляхів
можна надати, використовуючи опцію кілька разів.

-основний:КЛАС
Повідомляє компілятору, який CLASS містить точку входу. Корисно, коли ви є
компіляція кількох класів з методом Main.

-nostdlib, -nostdlib+
Використовуйте цей прапорець, якщо ви хочете скомпілювати основну бібліотеку. Це робить компілятор
завантажте його внутрішні типи зі збірки, що компілюється.

-noconfig, -noconfig+
Вимикає конфігурацію компілятора за замовчуванням для завантаження. Компілятор за замовчуванням
має посилання на збірки системи.

-nowarn:СПИСОК ПОПЕРЕДЖЕНЬ
Змушує компілятор ігнорувати попередження, зазначені в розділеному комами списку WARNLIST>

- оптимізувати, - оптимізувати +, -оптимізувати-
Контролює оптимізацію генерації коду компілятора в коді. Використання -optimize або
-optimize+ увімкне оптимізацію, -optimize- вимкне її. За замовчуванням в
mcs – оптимізувати-. Опцію можна змішати з -debug, але для найкращого налагодження
досвід рекомендується залишити параметри вимкненими.

-out:FNAME, -o ІМ'Я
Назви вихідний файл, який буде створено.

--розібрати
Використовується для порівняльного аналізу. Компілятор буде аналізувати лише свої вхідні файли.

-pkg:пакет1[,пакетN]
Довідкові збірки для даних пакетів.

Компілятор викличе pkg-config --libs для набору пакетів, зазначених у файлі
командний рядок для отримання бібліотек і каталогів для компіляції коду.

Зазвичай це використовується з компонентами сторонніх розробників, наприклад:

$ mcs -pkg:gtk-sharp demo.cs

-pkg:dotnet
Це дозволить компілятору посилатися на бібліотеки System.*
доступний у типовій інсталяції dotnet framework, зверніть увагу, що це так
не включати всі бібліотеки Mono, а лише System.*. Це
зручний ярлик для тих, хто переносить код.

-платформа: ARCH
Використовується для визначення цільової платформи. Можливі значення: anycpu,
переважний anycpu32bit, arm, x86, x64 або itanium. Опція за замовчуванням — будь-який процесор.

-ресурс:RESOURCE[,ID]
Вбудовується у вказаний файл ресурсу. Додатковий ідентифікатор можна використовувати для надання іншого
ім'я ресурсу. Якщо не вказано, ім’я ресурсу буде ім’ям файлу.

-linkresource:RESOURCE[,ID]
Посилання на вказаний РЕСУРС. Додатковий ідентифікатор можна використовувати, щоб дати назву
пов’язаний ресурс.

-r:ЗБІРКА1[,ЗБІРКА2], -довідка ЗБІРКА1[,ЗБІРКА2]
Посилання на названі збірки. Використовуйте це, щоб використовувати класи з названої збірки в
ваша програма. Збірка буде завантажена або з системного каталогу, де
всі збірки живі або зі шляху, явно заданого параметром -L.

Ви також можете використовувати крапку з комою для відокремлення збірок замість коми.

-посилання: ALIAS=ASSEMBLY
Підтримка зовнішніх довідкових псевдонімів для C#.

Якщо у вас є різні збірки, які надають однакові типи, зовнішній псевдонім
Підтримка дозволяє надати імена, які ваше програмне забезпечення може використовувати, щоб розповісти про них
апарт. Типи з ASSEMBLY відображатимуться як ALIAS, а потім у джерелі C#
код, вам потрібно зробити:

зовнішній псевдонім ALIAS;
Щоб внести його у свій простір імен. Наприклад, щоб впоратися з двома графічними бібліотеками
які визначають "Graphics.Point", один у "OpenGL.dll" і один у "Postscript.dll", ви
буде викликати компілятор таким чином:

mcs -r:Postscript=Postscript.dll -r:OpenGL=OpenGL.dll

І у своєму вихідному коді ви б написали:

зовнішній псевдонім Postscript;
зовнішній псевдонім OpenGL;

клас X {
// Це Graphics.Point із Postscrip.dll
Postscript.Point p = новий Postscript.Point ();

// Це Graphics.Point з OpenGL.dll
OpenGL.Point p = новий OpenGL.Point ();
}

-recurse: PATTERN, --рекурс ПАТЕРН
Виконує рекурсивну компіляцію з використанням зазначеного шаблону. У Unix оболонка буде
виконувати globbing, тому ви можете використовувати його так:

$ mcs -recurse: '*.cs'

-sdk: ВЕРСІЯ
Використовується для визначення версії збірок бібліотеки базових класів, що використовуються для компіляції.
Допустимі наступні попередньо визначені значення: 2, 4 (за замовчуванням), а також будь-яке користувацьке значення.
Попередньо визначений номер версії означає, яке користувацьке значення вказано, mcs спробує
знайдіть бібліотеки базових класів у встановленому монорозташуванні PREFIX/lib/mono/ .

-- оболонка
Запускає компілятор в інтерактивному режимі, надаючи оболонку C# для операторів і
вирази. Ярлик полягає у використанні csharp командувати безпосередньо.

-- трасування стека
Генерує трасування стека під час повідомлення про помилку, корисне для налагодження
компілятор.

-ціль: KIND, -t: ДОБРИЙ
Використовується для визначення бажаної мети. Можливі значення: exe (звичайний
виконуваний файл), winexe (виконуваний файл Windows.Forms), бібліотека (бібліотеки компонентів) та
модуль (часткова бібліотека).

--помітка часу
Ще один прапорець налагодження. Використовується для відображення часу в різних точках
процес складання.

- небезпечно, -небезпечно+
Дозволяє компіляцію небезпечного коду.

-v Налагодження. Вмикає детальний аналіз yacc.

-- версія
Показує версію компілятора.

-попереджувальна помилка, -warnaserror+
Усі попередження компілятора будуть відображатися як помилки.

-warnaserror:W1,[Wn], -warnaserror+:W1,[Wn]
Обробляє одне або кілька попереджень компілятора як помилки.

-warnaserror-:W1,[Wn]
Встановлює одне або кілька попереджень компілятора, які завжди загрожують як попередження. Стає
корисно при використанні разом з -warnaserror.

-попередити: РІВЕНЬ
Встановлює рівень попередження. 0 – найнижчий рівень попередження, а 4 – найвищий. The
за замовчуванням - 4.

-win32res:ФАЙЛ
Вказує файл ресурсу Win32 (.res), який буде об’єднано в отриману збірку.

-win32icon: ФАЙЛ
Приєднує піктограму, зазначену у FILE, на виході до отриманої збірки.

-- Використовуйте це, щоб зупинити розбір параметрів і дозволити передачу параметрів, що виглядають
у командному рядку.

ПАКЕТИ І БІБЛІОТЕКИ

При посиланні на збірку, якщо ім’ям збірки є шлях, компілятор спробує
щоб завантажити збірку, зазначену в шляху. Якщо це не так, компілятор спробує
завантаження збірки з поточного каталогу, базового каталогу компілятора і якщо
збірка не знайдена в жодному з цих місць у каталогах, зазначених як аргументи до
аргумент команди -lib:.

Компілятор використовує шлях до бібліотеки для пошуку бібліотек і може посилатися на бібліотеки
з певного пакета, якщо цей каталог використовується. Щоб спростити використання пакетів,
Компілятор C# включає параметр командного рядка -pkg:, який використовується для завантаження певних
колекції бібліотек.

Бібліотеки, видимі компілятору, зберігаються відносно префікса встановлення під
PREFIX/lib/mono/ називається PACKAGEBASE, а значення за замовчуванням для mcs, gmcs і smcs такі
наступним чином:

mcs Посилається на каталог PACKAGEBASE/1.0

gmcs Посилається на каталог PACKAGEBASE/2.0

smcs Посилається на каталог PACKAGEBASE/2.1

Це єдині існуючі профілі часу виконання. Хоча існують інші каталоги (наприклад
3.0 і 3.5) це насправді не профілі під час виконання, це просто заповнювачі для додаткових
бібліотеки, які базуються на основі 2.0.

Постачальники програмного забезпечення будуть розповсюджувати програмне забезпечення, яке встановлено відносно PACKAGEBASE
каталог. Це інтегровано в гакутіл інструмент, який не тільки встановлює загальнодоступні
збирає в глобальний кеш асамблей (GAC), але також встановлює їх у файл
Каталог PACKAGEBASE/PKG (де PKG - це ім'я, передане прапору -package до gacutil).

Як розробник, якщо ви хочете використовувати бібліотеки Gtk#, ви повинні викликати компілятор
подобається це:

$ mcs -pkg:gtk-sharp-2.0 main.cs

Параметр -pkg: наказує компілятору отримати визначення для gtk-sharp-2.0 з
pkg-config, це еквівалентно передачі компілятору C# результату:

$ pkg-config --libs gtk-sharp-2.0

Зазвичай це лише посилання на бібліотеки з PACKAGEBASE/PKG.

Хоча існують імена каталогів для 3.0 і 3.5, це не означає, що є 3.0
і 3.5 видання або профілі компілятора. Це просто нові бібліотеки, які повинні бути
вручну або за допомогою відповідного виклику -pkg:, або посилаючись на
безпосередньо бібліотеки.

СПЕЦІАЛЬНІ ВИЗНАЧАЄ

Команда СЛІД та DEBUG defines мають особливе значення для компілятора.

За замовчуванням виклики методів і властивостей у класі System.Diagnostics.Trace не є
генерується, якщо символ TRACE не визначено (або через "#define TRACE") у вашому
вихідний код, або за допомогою --визначити СЛІД в командному рядку.

За замовчуванням виклики методів і властивостей у класі System.Diagnostics.Debug не є
генерується, якщо символ DEBUG не визначено (або через "#define DEBUG") у вашому
вихідний код, або за допомогою --визначити DEBUG в командному рядку.

Зауважте, що ефект визначення TRACE і DEBUG є глобальним параметром, навіть якщо вони є
визначено лише в одному файлі.

ВІДМОВЛЕННЯ ПІДТРИМКА

При використанні прапора "-debug" MCS згенерує файл із розширенням .mdb that
містить інформацію про налагодження для згенерованої збірки. Цей файл споживає
налагоджувач Mono (mdb).

НАВКОЛИШНЄ СЕРЕДОВИЩЕ ЗМІННІ

MCS_COLORS
Якщо ця змінна встановлена, вона містить рядок у формі "передній план, фон"
який визначає, який колір використовувати для відображення помилок на деяких терміналах.

Фон є необов'язковим і за замовчуванням відповідає поточному фону терміналу. The
можливі кольори переднього плану: чорний, червоний, яскраво-червоний, зелений, яскраво-зелений,
жовтий, яскраво-жовтий, синій, яскраво-блакитний, пурпуровий, яскраво-пурпурний, блакитний, яскраво-блакитний,
сірий, білий і яскраво-білий.

Можливі кольори фону: чорний, червоний, зелений, жовтий, синій, пурпурний,
блакитний, сірий і білий.

Наприклад, ви можете встановити ці змінні зі своєї оболонки:
експортувати MCS_COLORS
MCS_COLORS=помилки=яскраво-білий,червоний

Ви можете вимкнути вбудовану колірну схему, встановивши для цієї змінної значення "disable".

ПРИМІТКИ

Під час компіляції компілятор MCS визначає символ __MonoCS__, його можна використовувати
інструкції попереднього процесора для компіляції коду компілятора Mono C#. Будь ласка, зверніть увагу, що
цей символ призначений лише для перевірки компілятором і не корисний для розрізнення компіляції
або платформи розгортання.

AUTHORS

Компілятор Mono C# написали Мігель де Іказа, Раві Пратап, Мартін Бауліг, Марек
Сафар і Раджа Харінатх. Розробку фінансували Ximian, Novell і Marek Safar.

Використовуйте dmcs онлайн за допомогою служб onworks.net