dmcs - En ligne dans le Cloud

PROGRAMME:

Nom

mcs - Compilateur Mono C#

SYNOPSIS

mcs [option] [fichiers-source]

DESCRIPTION

mcs est le compilateur Mono C#, une implémentation de la spécification du langage ECMA-334.
Vous pouvez passer une ou plusieurs options pour piloter le compilateur et un ensemble de fichiers source. Supplémentaire
des options ou des arguments peuvent être fournis dans un fichier de réponses. Les fichiers de réponses sont référencés par
en ajoutant le symbole @ au nom du fichier de réponses.

La mcs le compilateur est utilisé pour compiler avec la dernière version de la bibliothèque de classes de base Mono et
implémente entièrement les spécifications C# 1.0, 2.0, 3.0 et 4.0.

Voir la section sur les forfaits pour plus d'informations.

Le compilateur Mono C# accepte les mêmes options de ligne de commande que le compilateur Microsoft C#
Est-ce que. Ces options peuvent commencer par une barre oblique ou un tiret (/checked est identique à -checked).
De plus, certaines options de type GNU sont prises en charge, celles-ci commencent par "--". Tous spécifiques au MCS
les indicateurs qui ne sont pas disponibles dans le compilateur Microsoft C# sont disponibles uniquement avec le
Options de style GNU.

Les fichiers source C# doivent se terminer par une extension ".cs". La compilation du code source C# nécessite
tous les fichiers qui composent une bibliothèque, un module ou un exécutable à fournir sur la commande
ligne. Il n'y a pas de support pour la compilation partielle. Pour bénéficier des avantages d'une partie
compilation, vous devez compiler les programmes dans leurs propres assemblys, et référencer plus tard
avec le drapeau "-r".

Le compilateur Mono C# génère des images (fichiers .exe) qui contiennent du code d'octet CIL qui peut être
exécuté par tout système qui implémente une machine virtuelle Common Language Infrastructure
tels que le moteur d'exécution Microsoft .NET sous Windows ou le moteur d'exécution Mono sous Unix
systèmes. Les exécutables ne sont pas liés à un processeur ou à un système d'exploitation spécifique.

Le compilateur Mono C# par défaut ne référence que trois assemblys : mscorlib.dll, System.dll
et System.Xml.dll. Si vous souhaitez référencer des bibliothèques supplémentaires, vous devez spécifier manuellement
à l'aide de l'option de ligne de commande -pkg: ou de l'option de ligne de commande -r:. Alternativement si
vous voulez obtenir toutes les bibliothèques système, vous pouvez utiliser la ligne de commande -pkg:dotnet
option.

OPTIONS

--sur
Affiche des informations sur le compilateur Mono C#

--addmodule:MODULE1[,MODULE2]
Inclut les modules spécifiés dans l'assemblage résultant. Les modules sont créés par
appel du compilateur avec l'option -target:module

-vérifié, -vérifié+
Définit le mode de compilation par défaut sur « vérifié ». Cela rend toutes les opérations mathématiques
coché (la valeur par défaut est décochée).

-vérifié-
Définit le mode de compilation par défaut sur « non coché ». Cela fait tout le calcul
opérations décochées (c'est la valeur par défaut).

-clscheck-, -clscheck+
Désactive ou active les contrôles CLS (Common Language Specification) (il est activé
par défaut).

La Common Language Specification (CLS) définit un sous-ensemble interopérable de types comme
ainsi que les conventions que les compilateurs (producteurs CLS) et les développeurs doivent suivre pour
exposer le code à d'autres langages de programmation (consommateurs CLS).

-page de codes : ID
Spécifie la page de codes utilisée pour traiter les fichiers d'entrée à partir du point où ils sont
spécifié sur. Par défaut, les fichiers seront traités dans l'environnement dépendant
page de codes native. Le compilateur détectera également automatiquement les fichiers Unicode qui
avoir une marque d'octet intégrée au début.

D'autres encodages populaires sont 28591 (Latin1), 1252 (iso-8859-1) et 65001 (UTF-8).

MCS prend en charge quelques raccourcis : "utf8" peut être utilisé pour spécifier utf-8 au lieu de
l'utilisation du cryptique 65001 et "reset" restaure la gestion automatique des pages de codes.
Ces raccourcis ne sont pas disponibles sur le compilateur Microsoft.

-définir:SYMLIST, -d:SYMLISTE
Définit le symbole répertorié par la liste séparée par des points-virgules SYMLIST SYMBOL. Cette
peut être testé dans le code source par le préprocesseur, ou peut être utilisé par des méthodes
qui ont été marqués avec l'attribut conditionnel.

-déboguer, -déboguer+
Générer des informations de débogage. Pour obtenir des traces de pile avec des informations de débogage,
vous devez invoquer le runtime mono avec le drapeau `--debug'. Le débogage
les informations sont stockées dans un fichier MDB situé dans le même dossier de sortie que celui produit
Assemblée.

-déboguer-
Ne générez pas d'informations de débogage.

-delaysign+
Incorporez uniquement la clé publique du nom fort dans l'assembly. La signature effective doit être
effectué ultérieurement à l'aide de l'outil SN. Ceci est utile pour protéger la clé privée
pendant le développement. Notez que la signature différée ne peut être effectuée qu'à l'aide d'une clé de nom fort
fichier (pas un conteneur de clé). L'option équivaut à inclure [assembly :
AssemblyDelaySign (true)] dans votre code source. L'option du compilateur est prioritaire
sur les attributs.

-signe de retard-
Défaut. Donner un nom fort (signer) à l'assembly à l'aide du fichier de clé de nom fort (ou
récipient). L'option équivaut à inclure [assembly: AssemblyDelaySign
(faux)] dans votre code source. L'option du compilateur a priorité sur les attributs.

-doc:FICHIER
Extrait la documentation C#/XML du code source et stocke dans le fichier donné
DÉPOSER.

-rapport d'erreur
Ce drapeau est ignoré par le compilateur C# de Mono et n'est présent que pour permettre à MCS d'être
utilisé comme remplacement CSC pour msbuild/xbuild.

--mortel
Ceci est utilisé pour déboguer le compilateur. Cela fait que l'émission d'erreur génère un
exception qui peut être interceptée par un débogueur.

-alignement de fichiers
Ce drapeau est ignoré par le compilateur C# de Mono et n'est présent que pour permettre à MCS d'être
utilisé comme remplacement CSC pour msbuild/xbuild.

-chemins complets
Toute erreur ou avertissement de code source émis par le compilateur inclut le nom de fichier uniquement par
défaut. Cette option oblige le compilateur à émettre un chemin de fichier absolu à la place.

-fichier clé : FICHIER CLÉ
Nom fort (signe) l'assembly de sortie à l'aide de la paire de clés présente dans le
fichier de clé de nom fort (snk). Une paire de clés complète est requise par défaut (ou lors de l'utilisation
delaysign-). Un fichier contenant uniquement la clé publique peut être utilisé avec delaysign+. Les
L'option équivaut à inclure [assembly: AssemblyKeyFile ("KEYFILE")] dans votre
code source. L'option du compilateur a priorité sur les attributs.

-keycontainer:CONTENEUR
Nom fort (signe) l'assembly de sortie à l'aide de la paire de clés présente dans le
récipient. Notez que delaysign+ est ignoré lors de l'utilisation de conteneurs de clés. L'option est
équivaut à inclure [assembly : AssemblyKeyName ("CONTAINER")] dans votre source
code. L'option du compilateur a priorité sur les attributs.

-langversion:TEXTE
L'option spécifie la version de la langue à utiliser. L'ensemble de fonctionnalités est
différent dans chaque version C#. Ce commutateur peut être utilisé pour forcer le compilateur à
n'autorise qu'un sous-ensemble des fonctionnalités. Les valeurs possibles sont :

Réglage par défaut
Demandez au compilateur d'utiliser la dernière version. L'équivalent est d'omettre le
switch (il s'agit actuellement par défaut de la spécification du langage C# 4.0).

ISO-1 Restreindre le compilateur à n'utiliser que les premières fonctionnalités normalisées ISO. L'utilisation de
des fonctionnalités telles que les génériques, les classes statiques, les méthodes anonymes conduiront à
Erreur.

ISO-2 Restreindre le compilateur à n'utiliser que les deuxièmes fonctionnalités normalisées ISO. Cette
permet l'utilisation de génériques, de classes statiques, d'itérateurs et de méthodes anonymes
par exemple.

3 Restreindre le compilateur à utiliser uniquement les fonctionnalités disponibles dans C# 3.0 (un
surensemble de ISO-1 et ISO-2).

4 Restreindre le compilateur à utiliser uniquement les fonctionnalités disponibles dans C# 4.0
spécification.

expérimental
Active les fonctionnalités instables des versions à venir de la langue.

Notez que cet indicateur restreint uniquement les fonctionnalités de langue disponibles pour le
programmeur. Une version des assemblages produits peut être contrôlée à l'aide de SDK option.

-lib:LISTE DE CHEMIN
Chaque chemin spécifié dans la liste séparée par des virgules incitera le compilateur à rechercher
pour les bibliothèques dans ce chemin spécifié.

-L PATH
Indique au compilateur de rechercher des bibliothèques dans le chemin spécifié. Chemins multiples
peut être fourni en utilisant l'option plusieurs fois.

-principal : CLASSE
Indique au compilateur quelle CLASS contient le point d'entrée. Utile quand vous êtes
compiler plusieurs classes avec une méthode Main.

-nostdlib, -nostdlib+
Utilisez cet indicateur si vous souhaitez compiler la bibliothèque principale. Cela rend le compilateur
charger ses types internes à partir de l'assembly en cours de compilation.

-noconfig, -noconfig+
Désactive le chargement de la configuration par défaut du compilateur. Le compilateur par défaut
a des références aux assemblages système.

-nowarn : LISTE D'AVERTISSEMENT
Fait en sorte que le compilateur ignore les avertissements spécifiés dans la liste séparée par des virgules WARNLIST>

-optimiser, -optimiser+, -optimiser-
Contrôle les optimisations de génération de code du compilateur sur le code. En utilisant -optimize ou
-optimize+ activera les optimisations, -optimize- les désactivera. La valeur par défaut dans
mcs est d'optimiser-. L'option peut être mélangée avec -debug mais pour le meilleur débogage
expérience, il est recommandé de laisser les options désactivées.

-sortie : FNAME, -o FNOM
Nomme le fichier de sortie à générer.

--analyse
Utilisé pour l'analyse comparative. Le compilateur n'analysera que ses fichiers d'entrée.

-pkg:paquet1[,paquetN]
Assemblys de référence pour les packages donnés.

Le compilateur invoquera pkg-config --libs sur l'ensemble de packages spécifié sur le
ligne de commande pour obtenir des bibliothèques et des répertoires pour compiler le code.

Ceci est généralement utilisé avec des composants tiers, comme ceci :

$ mcs -pkg:gtk-sharp démo.cs

-pkg:dotnet
Cela demandera au compilateur de référencer les bibliothèques System.*
disponible sur une installation dotnet framework typique, notez que cela ne
n'inclut pas toutes les bibliothèques Mono, seulement celles System.*. C'est un
raccourci pratique pour ceux qui portent le code.

-plateforme : ARCH
Utilisé pour spécifier la plate-forme cible. Les valeurs possibles sont : anycpu,
anycpu32bitpreferred, arm, x86, x64 ou itanium. L'option par défaut est anycpu.

-resource:RESSOURCE[,ID]
Incorpore au fichier de ressources donné. L'ID facultatif peut être utilisé pour donner un autre
nom à la ressource. S'il n'est pas spécifié, le nom de la ressource sera le nom du fichier.

-linkresource:RESSOURCE[,ID]
Liens vers la RESSOURCE spécifiée. L'ID facultatif peut être utilisé pour donner un nom au
ressource liée.

-r:ENSEMBLE1[,ENSEMBLE2], -référence ASSEMBLAGE1[,ASSEMBLY2]
Référencez les assemblys nommés. Utilisez ceci pour utiliser les classes de l'assembly nommé dans
votre programme. L'assembly sera chargé à partir du répertoire système où
tous les assemblys en direct, ou à partir du chemin explicitement donné avec l'option -L.

Vous pouvez également utiliser un point-virgule pour séparer les assemblys au lieu d'une virgule.

-référence:ALIAS=ASSEMBLAGE
Prise en charge des références d'alias externes pour C#.

Si vous avez différents assemblys qui fournissent les mêmes types, l'alias externe
le support vous permet de fournir des noms que votre logiciel peut utiliser pour dire à ces
appart. Les types de ASSEMBLY seront exposés en tant qu'ALIAS, puis sur le source C#
code, vous devez faire:

alias externe ALIAS ;
Pour l'amener dans votre espace de nom. Par exemple, pour faire face à deux bibliothèques graphiques
qui définissent "Graphics.Point", un dans "OpenGL.dll" et un dans "Postscript.dll", vous
invoquerait le compilateur comme ceci :

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

Et dans votre code source, vous écririez :

alias externe Postscript ;
alias externe OpenGL ;

classe X {
// Ceci est un Graphics.Point de Postscrip.dll
Postscript.Point p = nouveau Postscript.Point ();

// Ceci est un Graphics.Point d'OpenGL.dll
OpenGL.Point p = nouveau OpenGL.Point ();
}

-recurse:MOTIF, --récurseur RECONNAISSANCE
Effectue une compilation récursive en utilisant le modèle spécifié. Sous Unix, le shell
effectuer le globbing, vous voudrez peut-être l'utiliser comme ceci :

$ mcs -recurse:'*.cs'

-sdk : VERSION
Utilisé pour spécifier la version des assemblys de la bibliothèque de classes de base utilisés pour la compilation.
Les valeurs prédéfinies suivantes sont valides : 2, 4 (par défaut) ainsi que toute valeur personnalisée.
Le numéro de version prédéfini signifie quelle valeur personnalisée est spécifiée que mcs essaiera de
recherchez les bibliothèques de classes de base dans l'emplacement d'installation mono PREFIX/lib/mono/ .

--coquille
Démarre le compilateur en mode interactif, fournissant un shell C# pour les instructions et
expressions. Un raccourci consiste à utiliser le tranchant commande directement.

--trace de la pile
Génère une trace de pile au moment où l'erreur est signalée, utile pour déboguer le
compilateur.

-cible : GENRE, -t:GENRE
Utilisé pour spécifier la cible souhaitée. Les valeurs possibles sont : exe (plain
exécutable), winexe (exécutable Windows.Forms), bibliothèque (bibliothèques de composants) et
module (bibliothèque partielle).

--horodatage
Un autre indicateur de débogage. Utilisé pour afficher les heures à divers points de la
processus de compilation.

-peu sûr, -dangereux+
Permet la compilation de code dangereux.

-v Débogage. Active l'analyse détaillée de yacc.

--version
Affiche la version du compilateur.

-warnaserror, -warnaserror+
Tous les avertissements du compilateur seront signalés comme des erreurs.

-warnaserror : W1,[Wn], -warnaserror+:W1,[Wn]
Traite un ou plusieurs avertissements du compilateur comme des erreurs.

-warnaserror-:W1,[Wn]
Définit un ou plusieurs avertissements du compilateur pour qu'ils soient toujours menacés en tant qu'avertissements. Devient
utile lorsqu'il est utilisé avec -warnaserror.

-warn:NIVEAU
Définit le niveau d'avertissement. 0 est le niveau d'avertissement le plus bas et 4 est le plus élevé. Les
la valeur par défaut est 4.

-win32res:FICHIER
Spécifie un fichier de ressources Win32 (.res) à intégrer dans l'assembly résultant.

-win32icon : FICHIER
Attache l'icône spécifiée dans FILE sur la sortie dans l'assemblage résultant.

-- Utilisez ceci pour arrêter l'analyse des options et autoriser la transmission des paramètres de recherche d'options
sur la ligne de commande.

FORFAITS ET BIBLIOTHÈQUES

Lors du référencement d'un assembly, si le nom de l'assembly est un chemin, le compilateur essaiera
pour charger l'assembly spécifié dans le chemin. Si ce n'est pas le cas, le compilateur essaiera
chargement de l'assembly depuis le répertoire courant, le répertoire de base du compilateur et si le
l'assembly n'est trouvé dans aucun de ces endroits dans les répertoires spécifiés comme arguments à
le -lib : argument de commande.

Le compilateur utilise le chemin de la bibliothèque pour localiser les bibliothèques et est capable de référencer des bibliothèques
à partir d'un package particulier si ce répertoire est utilisé. Pour simplifier l'utilisation des packages, le
Le compilateur C# inclut l'option de ligne de commande -pkg: qui est utilisée pour charger des
collections de bibliothèques.

Les bibliothèques visibles par le compilateur sont stockées par rapport au préfixe d'installation sous
PREFIX/lib/mono/ appelé PACKAGEBASE et les valeurs par défaut pour mcs, gmcs et smcs sont les suivantes
suit:

mcs Référence le répertoire PACKAGEBASE/1.0

gmc Référence le répertoire PACKAGEBASE/2.0

smcs Référence le répertoire PACKAGEBASE/2.1

Ce sont les seuls profils d'exécution qui existent. Bien que d'autres répertoires existent (comme
3.0 et 3.5) ce ne sont pas vraiment des profils d'exécution, ce sont simplement des espaces réservés pour des
bibliothèques qui s'appuient sur la base 2.0.

Les fournisseurs de logiciels distribueront les logiciels installés par rapport à PACKAGEBASE
annuaire. Celui-ci est intégré au gacutil outil qui installe non seulement public
assemblys dans le Global Assembly Cache (GAC) mais les installe également dans le
Répertoire PACKAGEBASE/PKG (où PKG est le nom passé à l'indicateur -package à gacutil).

En tant que développeur, si vous souhaitez utiliser les bibliothèques Gtk#, vous invoqueriez le compilateur
comme ça:

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

L'option -pkg: demande au compilateur de récupérer les définitions de gtk-sharp-2.0 à partir de
pkg-config, cela équivaut à passer au compilateur C# la sortie de :

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

Habituellement, cela fait simplement référence aux bibliothèques de PACKAGEBASE/PKG.

Bien qu'il existe des noms de répertoire pour 3.0 et 3.5, cela ne signifie pas qu'il existe 3.0
et 3.5 éditions ou profils du compilateur. Ce ne sont que de nouvelles bibliothèques qui doivent être
référencé manuellement soit avec le bon -pkg: invocation, soit en référençant le
bibliothèques directement.

SPECIAL DÉFINIT

La TRACE ainsi que DEBUG defines ont une signification particulière pour le compilateur.

Par défaut, les appels aux méthodes et propriétés de la classe System.Diagnostics.Trace ne sont pas
généré sauf si le symbole TRACE est défini (soit par un "#define TRACE") dans votre
code source, ou en utilisant le --définir TRACE dans la ligne de commande.

Par défaut, les appels aux méthodes et propriétés de la classe System.Diagnostics.Debug ne sont pas
généré sauf si le symbole DEBUG est défini (soit par un "#define DEBUG") dans votre
code source, ou en utilisant le --définir DEBUG dans la ligne de commande.

Notez que l'effet de la définition de TRACE et DEBUG est un paramètre global, même s'ils sont
uniquement défini dans un seul fichier.

DÉBOGAGE SUPPORT

Lors de l'utilisation de l'indicateur "-debug", MCS générera un fichier avec l'extension .mdb qui
contient les informations de débogage pour l'assembly généré. Ce fichier est consommé par
le débogueur Mono (mdb).

ENVIRONNEMENT VARIABLES

MCS_COLORS
Si cette variable est définie, elle contient une chaîne sous la forme "foreground,background"
qui spécifie la couleur à utiliser pour afficher les erreurs sur certains terminaux.

L'arrière-plan est facultatif et correspond par défaut à l'arrière-plan actuel de votre terminal. Les
les couleurs possibles pour le premier plan sont : noir, rouge, rouge vif, (en vert) vert clair,
jaune, jaune vif, bleu, bleu vif, magenta, magenta brillant, cyan, cyan brillant,
gris, blanc et blanc brillant.

Les couleurs possibles pour le fond sont : noir, rouge, vert, jaune, bleu, magenta,
cyan, gris et blanc.

Par exemple, vous pouvez définir ces variables depuis votre shell :
exporter MCS_COLORS
MCS_COLORS=errors=blanc brillant, rouge

Vous pouvez désactiver le schéma de couleurs intégré en définissant cette variable sur « désactiver ».

NOTES

Lors de la compilation, le compilateur MCS définit le symbole __MonoCS__, il peut être utilisé par
instructions de pré-processeur pour compiler le code spécifique au compilateur Mono C#. Veuillez noter que
ce symbole sert uniquement à tester le compilateur, et n'est pas utile pour distinguer la compilation
ou des plates-formes de déploiement.

AUTEURS

Le compilateur Mono C# a été écrit par Miguel de Icaza, Ravi Pratap, Martin Baulig, Marek
Safar et Raja Harinath. Le développement a été financé par Ximian, Novell et Marek Safar.

Utiliser les dmcs en ligne à l'aide des services onworks.net