~ubuntu-branches/ubuntu/precise/xdm/precise

« back to all changes in this revision

Viewing changes to xdm.man.cpp

  • Committer: Bazaar Package Importer
  • Author(s): Julien Cristau
  • Date: 2008-10-05 20:55:43 UTC
  • mfrom: (7.1.7 intrepid)
  • Revision ID: james.westby@ubuntu.com-20081005205543-t9lgih96kbj1eidd
Tags: 1:1.1.8-5
Updated Polish debconf translation, thanks to Łukasz Paździora
(closes: #499073).

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" $XdotOrg: app/xdm/xdm.man.cpp,v 1.5 2005/10/18 02:12:17 alanc Exp $
 
1
.\" $XdotOrg: xc/programs/xdm/xdm.man,v 1.3 2004/07/26 22:56:33 herrb Exp $
2
2
.\" $Xorg: xdm.man,v 1.4 2001/02/09 02:05:41 xorgcvs Exp $
3
3
.\" Copyright 1988, 1994, 1998  The Open Group
4
4
.\"
196
196
.IP "\fB\-resources\fP \fIresource_file\fP"
197
197
Specifies the value for the \fBDisplayManager*resources\fP resource.  This file
198
198
is loaded using
199
 
.I xrdb
 
199
.IR xrdb (__appmansuffix__)
200
200
to specify configuration parameters for the
201
201
authentication widget.
202
202
.IP "\fB\-server\fP \fIserver_entry\fP"
931
931
 
932
932
.fi
933
933
.SH "AUTHENTICATION WIDGET"
934
 
The authentication widget reads a name/password pair
935
 
from the keyboard.  Nearly every imaginable
 
934
The authentication widget prompts the user for the username, password, and/or
 
935
other required authentication data from the keyboard.  Nearly every imaginable
936
936
parameter can be controlled with a resource.  Resources for this widget
937
937
should be put into the file named by
938
938
\fBDisplayManager.\fP\fIDISPLAY\fP\fB.resources\fP.  All of these have reasonable
939
939
default values, so it is not necessary to specify any of them.
 
940
.PP
 
941
The resource file is loaded with
 
942
.IR xrdb (__appmansuffix__)
 
943
so it may use the substitutions defined by that program such as CLIENTHOST
 
944
for the client hostname in the login message, or C pre-processor #ifdef
 
945
statements to produce different displays depending on color depth or other
 
946
variables.
 
947
.PP
 
948
.I Xdm
 
949
can be compiled with support for the 
 
950
.IR Xft (__libmansuffix__) 
 
951
library for font rendering.   If this support is present, font faces are 
 
952
specified using the resources with names ending in "face" in the
 
953
fontconfig face format described in the 
 
954
.I Font Names
 
955
section of
 
956
.IR fonts.conf (__filemansuffix__).
 
957
If not, then fonts are specified using the resources with names ending in 
 
958
"font" in the traditional 
 
959
.I X Logical Font Description 
 
960
format described in the 
 
961
.I Font Names
 
962
section of 
 
963
.IR X (__miscmansuffix__).
940
964
.IP "\fBxlogin.Login.width, xlogin.Login.height, xlogin.Login.x, xlogin.Login.y\fP"
941
965
The geometry of the Login widget is normally computed automatically.  If you
942
966
wish to position it elsewhere, specify each of these resources.
943
967
.IP "\fBxlogin.Login.foreground\fP"
944
 
The color used to display the typed-in user name.
 
968
The color used to display the input typed by the user.
 
969
.IP "\fBxlogin.Login.face\fP"
 
970
The face used to display the input typed by the user when built with Xft 
 
971
support.  The default is ``Serif-18''.
945
972
.IP "\fBxlogin.Login.font\fP"
946
 
The font used to display the typed-in user name.
 
973
The font used to display the input typed by the user when not built with Xft
 
974
support.
947
975
.IP "\fBxlogin.Login.greeting\fP"
948
976
A string which identifies this window.
949
977
The default is ``X Window System.''
951
979
When X authorization is requested in the configuration file for this
952
980
display and none is in use, this greeting replaces the standard
953
981
greeting.  The default is ``This is an unsecure session''
 
982
.IP "\fBxlogin.Login.greetFace\fP"
 
983
The face used to display the greeting when built with Xft support.
 
984
The default is ``Serif-24:italic''.
954
985
.IP "\fBxlogin.Login.greetFont\fP"
955
 
The font used to display the greeting.
 
986
The font used to display the greeting when not built with Xft support.
956
987
.IP "\fBxlogin.Login.greetColor\fP"
957
988
The color used to display the greeting.
958
989
.IP "\fBxlogin.Login.namePrompt\fP"
962
993
the end of the prompt (usually a nice thing), add spaces escaped with
963
994
backslashes.  The default is ``Login:  ''
964
995
.IP "\fBxlogin.Login.passwdPrompt\fP"
965
 
The string displayed to prompt for a password.
 
996
The string displayed to prompt for a password, when not using an authentication
 
997
system such as PAM that provides its own prompts.
966
998
The default is ``Password:  ''
 
999
.IP "\fBxlogin.Login.promptFace\fP"
 
1000
The face used to display prompts when built with Xft support.
 
1001
The default is ``Serif-18:bold''.
967
1002
.IP "\fBxlogin.Login.promptFont\fP"
968
 
The font used to display both prompts.
 
1003
The font used to display prompts when not built with Xft support.
969
1004
.IP "\fBxlogin.Login.promptColor\fP"
970
 
The color used to display both prompts.
 
1005
The color used to display prompts.
 
1006
.IP "\fBxlogin.Login.changePasswdMessage\fP"
 
1007
A message which is displayed when the users password has expired.
 
1008
The default is ``Password Change Required''
971
1009
.IP "\fBxlogin.Login.fail\fP"
972
 
A message which is displayed when the authentication fails.
 
1010
A message which is displayed when the authentication fails, when not using an
 
1011
authentication system such as PAM that provides its own prompts.
973
1012
The default is ``Login incorrect''
 
1013
.IP "\fBxlogin.Login.failFace\fP"
 
1014
The face used to display the failure message when built with Xft support.
 
1015
The default is ``Serif-18:bold''.
974
1016
.IP "\fBxlogin.Login.failFont\fP"
975
 
The font used to display the failure message.
 
1017
The font used to display the failure message when not built with Xft support.
976
1018
.IP "\fBxlogin.Login.failColor\fP"
977
1019
The color used to display the failure message.
978
1020
.IP "\fBxlogin.Login.failTimeout\fP"
979
1021
The number of seconds that the failure message is displayed.
980
 
The default is 30.
 
1022
The default is 10.
 
1023
.IP "\fBxlogin.Login.logoFileName\fP"
 
1024
Name of an XPM format pixmap to display in the greeter window, if built with
 
1025
XPM support.   The default is no pixmap.
 
1026
.IP "\fBxlogin.Login.logoPadding\fP"
 
1027
Number of pixels of space between the logo pixmap and other elements of the
 
1028
greeter window, if the pixmap is displayed.
 
1029
The default is 5.
 
1030
.IP "\fBxlogin.Login.useShape\fP"
 
1031
If set to ``true'', when built with XPM support, attempt to use the
 
1032
X Non-Rectangular Window Shape Extension to set the window shape.
 
1033
The default is ``true''.
 
1034
.IP "\fBxlogin.Login.hiColor\fP, \fBxlogin.Login.shdColor\fP"
 
1035
Raised appearance bezels may be drawn around
 
1036
the greeter frame and text input boxes by setting these resources.  hiColor
 
1037
is the highlight color, used on the top and left sides of the frame, and the
 
1038
bottom and right sides of text input areas.   shdColor is the shadow color,
 
1039
used on the bottom and right sides of the frame, and the top and left sides
 
1040
of text input areas.
 
1041
The default for both is the foreground color, providing a flat appearance.
 
1042
.IP "\fBxlogin.Login.frameWidth\fP"
 
1043
frameWidth is the width in pixels of the area
 
1044
around the greeter frame drawn in hiColor and shdColor.
 
1045
.IP "\fBxlogin.Login.innerFramesWidth\fP"
 
1046
innerFramesWidth is the width in pixels of the 
 
1047
area around text input areas drawn in hiColor and shdColor.
 
1048
.IP "\fBxlogin.Login.sepWidth\fP"
 
1049
sepWidth is the width in pixels of the 
 
1050
bezeled line between the greeting and input areas
 
1051
drawn in hiColor and shdColor.
981
1052
.IP "\fBxlogin.Login.allowRootLogin\fP"
982
1053
If set to ``false'', don't allow root (and any other user with uid = 0) to
983
1054
log in directly.
1092
1163
        PATH    the value of \fBDisplayManager.\fP\fIDISPLAY\fP\fB.systemPath\fP
1093
1164
        SHELL   the value of \fBDisplayManager.\fP\fIDISPLAY\fP\fB.systemShell\fP
1094
1165
        XAUTHORITY      may be set to an authority file
 
1166
        WINDOWPATH      may be set to the "window path" leading to the X server
1095
1167
 
1096
1168
.fi
1097
1169
.PP
1146
1218
        SHELL   the user's default shell (from \fIgetpwnam\fP)
1147
1219
        XAUTHORITY      may be set to a non-standard authority file
1148
1220
        KRB5CCNAME      may be set to a Kerberos credentials cache name
 
1221
        WINDOWPATH      may be set to the "window path" leading to the X server
1149
1222
 
1150
1223
.fi
1151
1224
.PP
1154
1227
which contains commands that each user would like to use as a session.
1155
1228
\fIXsession\fP should also
1156
1229
implement a system default session if no user-specified session exists.
1157
 
See the section \fBTypical Usage\fP.
1158
1230
.PP
1159
1231
An argument may be passed to this program from the authentication widget
1160
1232
using the `set-session-argument' action.  This can be used to select
1366
1438
Kerberos credentials cache
1367
1439
.SH "SEE ALSO"
1368
1440
.IR X (__miscmansuffix__),
1369
 
.IR xinit (1),
1370
 
.IR xauth (1),
 
1441
.IR xinit (__appmansuffix__),
 
1442
.IR xauth (__appmansuffix__),
 
1443
.IR xrdb (__appmansuffix__),
1371
1444
.IR Xsecurity (__miscmansuffix__),
1372
 
.IR sessreg (1),
1373
 
.IR Xserver (1),
1374
 
.\" .IR chooser (1), \" except that there isn't a manual for it yet
1375
 
.\" .IR xdmshell (1), \" except that there isn't a manual for it yet
 
1445
.IR sessreg (__appmansuffix__),
 
1446
.IR Xserver (__appmansuffix__),
 
1447
.\" .IR chooser (__appmansuffix__), \" except that there isn't a manual for it yet
 
1448
.\" .IR xdmshell (__appmansuffix__), \" except that there isn't a manual for it yet
 
1449
.IR fonts.conf (__filemansuffix__).
1376
1450
.br
1377
1451
.I "X Display Manager Control Protocol"
1378
1452
.SH AUTHOR