1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
/*
* nvidia-settings: A tool for configuring the NVIDIA X driver on Unix
* and Linux systems.
*
* Copyright (C) 2010 NVIDIA Corporation.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms and conditions of the GNU General Public License,
* version 2, as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses>.
*/
#ifndef __OPTION_TABLE_H__
#define __OPTION_TABLE_H__
#include "nvgetopt.h"
#include "command-line.h"
#define TAB " "
#define BIGTAB " "
/*
* Options table; see nvgetopt.h for a description of the fields, and
* gen-manpage-opts.c:print_option() for a description of special
* characters that are converted during manpage generation.
*/
static const NVGetoptOption __options[] = {
{ "version", 'v', NVGETOPT_HELP_ALWAYS, NULL,
"Print the ^nvidia-settings^ version and exit." },
{ "help", 'h', NVGETOPT_HELP_ALWAYS, NULL,
"Print usage information and exit." },
{ "config", CONFIG_FILE_OPTION,
NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"Use the configuration file &CONFIG& rather than the "
"default &" DEFAULT_RC_FILE "&" },
{ "ctrl-display", 'c',
NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"Control the specified X display. If this option is not given, then "
"^nvidia-settings^ will control the display specified by ^'--display'^; "
"if that is not given, then the &$DISPLAY& environment "
"variable is used." },
/*
* This is a silent, hidden option for the GTK argument that we treat
* identically to the above "ctrl-display" option.
*/
{ "display", DISPLAY_OPTION, NVGETOPT_STRING_ARGUMENT, NULL, NULL },
{ "load-config-only", 'l', NVGETOPT_HELP_ALWAYS, NULL,
"Load the configuration file, send the values specified therein to "
"the X server, and exit. This mode of operation is useful to place "
"in your xinitrc file, for example." },
{ "no-config", 'n', NVGETOPT_HELP_ALWAYS, NULL,
"Do not load the configuration file. This mode of operation is useful "
"if ^nvidia-settings^ has difficulties starting due to problems with "
"applying settings in the configuration file." },
{ "rewrite-config-file", 'r', NVGETOPT_HELP_ALWAYS, NULL,
"Write the X server configuration to the configuration file, and exit, "
"without starting the graphical user interface. See EXAMPLES section." },
{ "verbose", 'V',
NVGETOPT_STRING_ARGUMENT | NVGETOPT_ARGUMENT_IS_OPTIONAL |
NVGETOPT_HELP_ALWAYS, NULL,
"Controls how much information is printed. Valid values are ^'none'^ "
"(do not print status messages), ^'errors'^ (print error messages), "
"^'deprecations'^ (print error and deprecation messages), ^'warnings'^ "
"(print error, deprecation, and warning messages), and ^'all'^ (print "
"error, deprecation, warning and other informational messages). By "
"default, ^'deprecations'^ is set." },
{ "assign", 'a', NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"The &ASSIGN& argument to the ^'--assign'^ command line option is of the "
"form:\n"
"\n"
TAB "{DISPLAY}/{attribute name}[{display devices}]={value}\n"
"\n"
"This assigns the attribute {attribute name} to the value {value} on the "
"X Display {DISPLAY}. {DISPLAY} follows the usual {host}:{display}."
"{screen} syntax of the DISPLAY environment variable and is optional; "
"when it is not specified, then it is implied following the same rule as "
"the ^--ctrl-display^ option. If the X screen is not specified, then the "
"assignment is made to all X screens. Note that the '/' is only required "
"when {DISPLAY} is present.\n"
"\n"
"{DISPLAY} can additionally include a target specification to direct "
"an assignment to something other than an X screen. A target "
"specification is contained within brackets and consists of a target "
"type name, a colon, and the target id. The target type name can be "
"one of ^\"screen\", \"gpu\", \"framelock\", \"vcs\", \"gvi\", \"fan\", "
"\"thermalsensor\", \"svp\",^ or ^\"dpy\";^ the target id is the index "
"into the list of targets (for that target type). The target "
"specification can be used in {DISPLAY} wherever an X screen can be used, "
"following the syntax {host}:{display}[{target_type}:{target_id}]. See "
"the output of\n"
"\n"
TAB "nvidia-settings -q all \n"
"\n"
"for information on which target types can be used with which "
"attributes. See the output of\n"
"\n"
TAB " nvidia-settings -q screens -q gpus -q framelocks -q vcs -q gvis "
"-q fans -q thermalsensors -q svps -q dpys \n"
"\n"
"for lists of targets for each target type.\n"
"\n"
"The [{display devices}] portion is also optional; if it is not "
"specified, then the attribute is assigned to all display devices.\n"
"\n"
"Some examples:\n"
"\n"
TAB "-a FSAA=5\n"
TAB "-a localhost:0.0/DigitalVibrance[CRT-0]=0\n"
TAB "--assign=\"SyncToVBlank=1\"\n"
TAB "-a [gpu:0]/DigitalVibrance[DFP-1]=63\n" },
{ "query", 'q', NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"The &QUERY& argument to the ^'--query'^ command line option is of the "
"form:\n"
"\n"
TAB "{DISPLAY}/{attribute name}[{display devices}]\n"
"\n"
"This queries the current value of the attribute {attribute name} on the "
"X Display {DISPLAY}. The syntax is the same as that for the "
"^'--assign'^ option, without '=^{value}'^; specify ^'-q screens', "
"'-q gpus', '-q framelocks', '-q vcs', '-q gvis', '-q fans'^, "
"'-q thermalsensors', '-q svps', or '-q dpys' to query a list of X "
"screens, GPUs, Frame Lock devices, Visual Computing Systems, SDI Input "
"Devices, Fans, Thermal Sensors, 3D Vision Pro Transceivers, or Display "
"Devices, respectively, that are present on the X Display {DISPLAY}. "
"Specify ^'-q all'^ to query all attributes." },
{ "terse", 't', NVGETOPT_HELP_ALWAYS, NULL,
"When querying attribute values with the '--query' command line option, "
"only print the current value, rather than the more verbose description "
"of the attribute, its valid values, and its current value." },
{ "display-device-string", 'd', NVGETOPT_HELP_ALWAYS, NULL,
"When printing attribute values in response to the '--query' option, "
"if the attribute value is a display device mask, print the value "
"as a list of display devices (e.g., \"CRT-0, DFP-0\"), rather than "
"a hexadecimal bit mask (e.g., 0x00010001)." },
{ "glxinfo", 'g', NVGETOPT_HELP_ALWAYS, NULL,
"Print GLX Information for the X display and exit." },
{ "describe", 'e', NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"Prints information about a particular attribute. Specify 'all' to "
"list the descriptions of all attributes. Specify 'list' to list the "
"attribute names without a descriptions." },
{ "page", 'p', NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"The &PAGE& argument to the ^'--page'^ commandline option selects a "
"particular page in the nvidia-settings user interface to display "
"upon starting nvidia-settings. Valid values are the page names "
"in the tree view on the left side of the nvidia-settings user "
"interface; e.g.,\n"
"\n"
TAB "--page=\"X Screen 0\"\n"
"\n"
"Because some page names are not unique (e.g., a \"PowerMizer\" page is "
"present under each GPU), the page name can optionally be prepended "
"with the name of the parent X Screen or GPU page, followed by a comma. "
"E.g.,\n"
"\n"
TAB "--page=\"GPU 0 - (Quadro 6000), PowerMizer\"\n"
"\n"
"The first page with a name matching the &PAGE& argument will be used. "
"By default, the \"X Server Information\" page is displayed." },
{ "list-targets-only", 'L', NVGETOPT_HELP_ALWAYS, NULL,
"When performing an attribute query (from the '--query' command line "
"option) or an attribute assignment (from the '--assign' command line "
"option or when loading an ~/.nvidia-settings-rc file), nvidia-settings "
"identifies one or more targets on which to query/assign the attribute.\n"
"\n"
"The '--list-targets-only' option will cause nvidia-settings to list the "
"targets on which the query/assign operation would have been performed, "
"without actually performing the operation(s), and exit." },
{ "write-config", 'w', NVGETOPT_IS_BOOLEAN | NVGETOPT_HELP_ALWAYS, NULL,
"Save the configuration file on exit (enabled by default)." },
{ "use-gtk2", 'i', NVGETOPT_HELP_ALWAYS, NULL, "Force nvidia-settings to "
"use the GTK+ 2 library for the graphical user interface if a user "
"interface is required. This option is only available on systems where "
"nvidia-settings supports both the GTK+ 2 and GTK+ 3 user "
"interfaces.\n" },
{ "gtk-library", 'I', NVGETOPT_STRING_ARGUMENT | NVGETOPT_HELP_ALWAYS, NULL,
"Specify the graphical user interface library to use if a "
"nvidia-settings user interface is required. This value may be the exact "
"location of the library or it may be the directory containing the "
"appropriately named library. If this is the exact location, the "
"'use-gtk2' option is ignored.\n" },
{ NULL, 0, 0, NULL, NULL},
};
#endif //_OPTION_TABLE_H
|
