Commande X

Pour spécifier le type visuel et la profondeur du visuel par défaut, utilisez les indicateurs -cc et -d , respectivement.

Les valeurs du paramètre VisualType sont spécifiées sous la forme d'une chaîne ou d'un nombre, comme suit:

String  Numeric equivalent
StaticGray		0
GrayScale		1
StaticColor		2
PseudoColor		3		
TrueColor		4
DirectColor		5	

Le paramètre :Display est facultatif, mais utile lors de l'utilisation de l'option multihead et doit correspondre aux valeurs transmises avec l'indicateur -P . Le paramètre :Display est le nom de l'affichage, comme indiqué dans la commande lsdisp . En l'absence du paramètre :Afficher , la profondeur spécifiée est sélectionnée pour tous les affichages sélectionnés dans l'option multitête, comme indiqué dans l'indicateur -P .

X -n :18

indique que la communication avec le serveur X activé est effectuée par unix:18 ou par Hostname: 18.

Le paramètre Display est le nom d'unité de l'affichage, comme indiqué dans la première colonne de la sortie de la commande Isdisp . La première occurrence de " -P "RowColumn " Affichage sur la ligne de commande décrit l'écran 0 au serveur X, la deuxième décrit l'écran 1, et ainsi de suite.

L'indicateur -P est destiné à être utilisé avec la prise en charge de plusieurs têtes.

Le paramètre level indique la quantité relative de mémoire tampon de trame à réserver pour les pbuffers. Les valeurs spécifiées doivent être comprises dans la plage [ 0 .. 2 ]. La valeur 0 indique qu'aucune mémoire ne doit être réservée pour les pbuffers. La valeur 1 indique qu'une faible quantité de mémoire doit être réservée. La valeur 2 indique qu'une quantité élevée de mémoire doit être réservée. Tous les adaptateurs ne prennent pas en charge les pbuffers. Pour ceux qui le font, toutes les configurations d'écran ne prennent pas en charge les pbuffers. La quantité réelle de mémoire tampon de trame réservée aux pbuffers dépend de l'unité et peut être influencée par d'autres facteurs, tels que la résolution d'écran ou la profondeur de pixel par défaut.

Le paramètre :display est facultatif, mais utile lors de l'utilisation de l'option multihead. Le paramètre :display est le nom de l'affichage, comme indiqué dans la commande lsdisp . Si aucun nombre ou nom d'affichage n'est fourni, la largeur pbuffer spécifiée est sélectionnée pour tous les écrans.

Les écrans pris en charge configureront l'adaptateur pour fournir la meilleure prise en charge disponible pour la stéréo. Cela peut diminuer d'autres ressources telles que la mémoire de texture. La quantité réelle de mémoire affectée dépend de l'unité et peut être influencée par d'autres facteurs, tels que la résolution d'écran ou la profondeur de pixel par défaut.

Le paramètre Display est facultatif, mais utile lors de l'utilisation de l'option multihead. Le paramètre Display est le nom de l'affichage, comme indiqué dans la commande lsdisp . Si aucun numéro d'affichage ou nom n'est fourni, l'indicateur -stereo se rapporte à tous les écrans pris en charge.

Les écrans non pris en charge ignoreront l'indicateur -stereo .

Inversement, si cet indicateur est activé et que la zone sensible de la souris atteint la bordure droite de la fenêtre racine la plus à droite, la souris est automatiquement positionnée à la bordure gauche de la fenêtre racine la plus à gauche à la même position y. Si cet indicateur n'est pas défini, la souris s'arrête à la bordure gauche ou droite d'une fenêtre racine.

Si cet indicateur est défini et que la zone sensible de la souris atteint la bordure supérieure de la fenêtre racine la plus haute, la souris est positionnée à la bordure inférieure de la fenêtre racine la plus basse à la même position x.

Inversement, si cet indicateur est activé et que la zone sensible de la souris atteint la bordure inférieure de la fenêtre racine la plus basse, la souris est positionnée à la bordure supérieure de la fenêtre racine la plus haute à la même position x.

L'indicateur -wrap est destiné à être utilisé avec la prise en charge de plusieurs têtes.

L'indicateur -wrapx est destiné à être utilisé avec la prise en charge de plusieurs têtes.

Inversement, si cet indicateur est activé et que la zone sensible de la souris atteint la bordure inférieure de la fenêtre racine la plus basse, la souris est positionnée à la bordure supérieure de la fenêtre racine la plus haute à la même position x. Si cet indicateur n'est pas défini, la souris s'arrête à la bordure supérieure ou inférieure d'une fenêtre racine.

L'indicateur -wrapy est destiné à être utilisé avec la prise en charge de plusieurs têtes.

L'indicateur -query doit être utilisé avec XDMCP.

L'indicateur -broadcast est destiné à être utilisé avec XDMCP.

L'indicateur -indirect doit être utilisé avec XDMCP.

L'indicateur -port doit être utilisé avec XDMCP.

L'indicateur -class doit être utilisé avec XDMCP.

L'indicateur -cookie est destiné à être utilisé avec XDMCP.

L'option -displayID est destinée à être utilisée avec XDMCP.

La syntaxe du fichier de règles de sécurité est la suivante. Notation: "*" signifie zéro ou plusieurs occurrences de l'élément précédent, et "+" signifie une ou plusieurs occurrences. Pour interpréter foo/barre, ignorez le texte après le / ; il est utilisé pour distinguer les instances de foo dans la section suivante.

policy file ::= version line other line*
version line ::= string/v '\n'
other line  ::= comment | access rule | site policy | blank line
comment ::= # not newline* '\n'
blank line ::= space '\n'
site policy ::= sitepolicy string/sp '\n'
access rule ::= property property/ar window perms '\n'
property ::= string
window ::= any | root | required property
required property ::= property/rp | property with value
property with value ::= property/rpv = string/rv
perms ::= [ operation | action | space ]*
operation ::= r | w | d
action ::= a | i | e
string ::= dbl quoted string | single quoted string | unquoted string
dbl quoted string ::= space " not dqoute* " space
single quoted string ::= space ' not squote* ' space
unquoted string ::= space not space+ space
space ::= [ ' ' | '\t' ]*

Jeux de caractères:

not newline ::= any character except '\n'
not dqoute  ::= any character except "
not squote  ::= any character except '
not space   ::= any character except those in space

La sémantique associée à la syntaxe décrite précédemment est la suivante.

ligne de version

La première ligne du fichier indique la version du format de fichier. Si le serveur ne reconnaît pas la version chaîne/v, il ignore le reste du fichier. La chaîne de version du format de fichier décrit ici estversion-1.

Une fois la ligne de versionpassée, les lignes qui ne correspondent pas à la syntaxe ci-dessus sont ignorées.

Commentaire

Les lignes sont ignorées.

politique du site

Les lignes sont actuellement ignorées. Ils sont destinés à spécifier les règles de site utilisées par la méthode d'autorisation XC-QUERY-SECURITY-1 .

règle d'accès

Les lignes indiquent comment le serveur doit réagir aux demandes client non sécurisées qui affectent la propriété X Window nommée property/ar. Le reste de cette section décrit l'interprétation d'une règle d'accès.

Pour qu'une règle d'accès s'applique à une instance donnée de la propriété /ar, La propriété /ar doit se trouver dans une fenêtre qui se trouve dans l'ensemble de fenêtres spécifié par window. Si window est any, la règle s'applique à la propriété /ar dans n'importe quelle fenêtre. Si window est root, la règle s'applique à la propriété /ar uniquement sur les fenêtres root.

Si window est la propriété requise, les conditions suivantes s'appliquent. Si la propriété requise est une propriété /rp, la règle s'applique lorsque la fenêtre comporte également cette propriété /rp, quelle que soit sa valeur. Si required property est une propriété avec la valeur, La propriété /rpv doit également avoir la valeur spécifiée par string/rv. Dans ce cas, la propriété doit avoir le type STRING et le format 8 et doit contenir une ou plusieurs chaînes à terminaison nulle. Si l'une des chaînes correspond à string/rv, la règle s'applique.

La définition de la correspondance de chaîne est une simple comparaison de chaînes sensibles à la casse avec une seule élaboration: l'occurrence du caractère'*'dans chaîne/rv est un caractère générique signifiant "n'importe quelle chaîne". Une chaîne/rv peut contenir plusieurs caractères génériques n'importe où dans la chaîne. Par exemple :x*correspond aux chaînes qui commencent par x,*xcorrespond aux chaînes qui se terminent par x,*x*correspond aux chaînes contenant x, etx*y*correspond aux chaînes commençant par x et contenant ensuite y.

Il peut y avoir plusieurs lignes de règle d'accès pour une propriété donnée/ar. Les règles sont testées dans l'ordre dans lequel elles apparaissent dans le fichier. La première règle qui s'applique est utilisée.

perms

Indiquez les opérations que les clients non dignes de confiance peuvent tenter et les actions que le serveur doit effectuer en réponse à ces opérations.

operation

Peut être r (lecture), w (écriture) ou d (suppression). Les informations suivantes montrent comment les demandes de propriété de protocole X sont mappées à ces opérations dans l'implémentation du serveur X Consortium.

GetProperty

rou r et d si delete = True

ChangeProperty

w

RotateProperties

r et w

DeleteProperty

d

ListProperties

aucun, les clients non dignes de confiance peuvent toujours répertorier toutes les propriétés

action

Peut être a (allow), i (ignore) ou e (error).

Autoriser

Exécute la demande comme si elle avait été émise par un client sécurisé.

Ignorer

Traite la demande comme une non-opération. Dans le cas de GetProperty, ignorer signifie renvoyer une valeur vide si la propriété existe, quelle que soit sa valeur réelle.

Erreur

Indique de ne pas exécuter la demande et de renvoyer unBadAtomerreur avec laatomdéfini sur le nom de la propriété. L'erreur est l'action par défaut pour toutes les propriétés, y compris celles qui ne sont pas répertoriées dans le fichier de règles de sécurité.

Une action s'applique à toutes les opérationsqui la suivent, jusqu'à ce que l' action> suivante soit rencontrée. Ainsi,irwadsignifie ignorer la lecture et l'écriture, autoriser la suppression.

GetProperty et RotateProperties peuvent effectuer plusieurs opérations (r et d, ou r et w). Si des actions différentes s'appliquent aux opérations, l'action la plus grave est appliquée à l'ensemble de la demande ; il n'y a pas d'exécution partielle de la demande. L'ordre de gravité est: allow < ignore < erreur. Ainsi, si les perms d'une propriété sontired(ignorer la lecture, erreur de suppression) et un client non digne de confiance tente de GetProperty sur cette propriété avecdelete = True, une erreur est renvoyée, mais la valeur de la propriété ne l'est pas. De même, si l'une des propriétés d'une propriété RotateProperties n'autorise pas à la fois la lecture et l'écriture, une erreur est renvoyée sans modifier les valeurs de propriété.

Voici un exemple de fichier de règles de sécurité:

version-1

# Allow reading of application resources, but not writing.
property RESOURCE_MANAGER     root      ar iw
property SCREEN_RESOURCES     root      ar iw

# Ignore attempts to use cut buffers.  Giving errors causes apps to crash,
# and allowing access may give away too much information.
property CUT_BUFFER0          root      irw
property CUT_BUFFER1          root      irw
property CUT_BUFFER2          root      irw
property CUT_BUFFER3          root      irw
property CUT_BUFFER4          root      irw
property CUT_BUFFER5          root      irw
property CUT_BUFFER6          root      irw
property CUT_BUFFER7          root      irw

# If you are using Motif, you probably want these.

property _MOTIF_DEFAULT_BINDINGS        rootar iw
property _MOTIF_DRAG_WINDOW   root      ar iw
property _MOTIF_DRAG_TARGETS  any       ar iw
property _MOTIF_DRAG_ATOMS    any       ar iw
property _MOTIF_DRAG_ATOM_PAIRS         any ar iw

# The next two rules let xwininfo -tree work when untrusted.
property WM_NAME              any       ar

# Allow read of WM_CLASS, but only for windows with WM_NAME.
# This might be more restrictive than necessary, but demonstrates
# the required property facility, and is also an attempt to
# say "top level windows only."
property WM_CLASS             WM_NAME   ar

# These next three let xlsclients work untrusted.  Think carefully
# before including these; giving away the client machine name and command
# may be exposing too much.
property WM_STATE             WM_NAME   ar
property WM_CLIENT_MACHINE    WM_NAME   ar
property WM_COMMAND           WM_NAME   ar

# To let untrusted clients use the standard colormaps created by
# xstdcmap, include these lines.
property RGB_DEFAULT_MAP      root      ar
property RGB_BEST_MAP         root      ar
property RGB_RED_MAP          root      ar
property RGB_GREEN_MAP        root      ar
property RGB_BLUE_MAP         root      ar
property RGB_GRAY_MAP         root      ar

# To let untrusted clients use the color management database created
# by xcmsdb, include these lines.
property XDCCC_LINEAR_RGB_CORRECTION    rootar
property XDCCC_LINEAR_RGB_MATRICES      rootar
property XDCCC_GRAY_SCREENWHITEPOINT    rootar
property XDCCC_GRAY_CORRECTION          rootar


# oddball property names and explicit specification of error conditions
property "property with spaces"         'property with "'aw er ed

# Allow deletion of Woo-Hoo if window also has property OhBoy with value
# ending in "son".  Reads and writes will cause an error.
property Woo-Hoo              OhBoy = "*son"ad