1Mono(mconfig) Mono(mconfig)
2
6 mconfig, - Utility for modifying .NET configuration files
7
9 mconfig [options] command [command_parameters]
10
12 mconfig can be used to edit .NET configuration files, by adding "fea‐
13 tures" (that is sets of xml statements) defined in one of the config
14 files read by mconfig. The config file can also define layouts of
15 default configuration files, which may be useful for bootstrapping your
16 .NET projects.
17 To see the list of recognized commands, default configuration files and
19 features, run mconfig without passing any parameters.
20
22 -c <config_file>, --config=<config_file>
23 Read the specified config file after reading the other, precon‐
24 figured, config files for the utility. Settings in the specified
25 file override those found in the other configuration locations.
26 -t {any | web | application}, --target={any | web | application}
28 Features and default configuration files defined in the mconfig
29 config file(s) can be assigned to one of the three targets - web
30 (for ASP.NET features/config files), application - for .NET
31 applications, any - applicable in both of the previous targets.
32 Defaults to any.
33 -?, -h, --help
35 Show a summary usage screen.
36 -v, --version
38 Show the mconfig version
39
41 {addfeature, af} <feature_name> [config_file_path]
42 Adds the feature named <feature_name> to the specified config
43 file. If [config_file_path] is omitted, the name of the output
44 configuration file will be chosen based on the selected target
45 (see the -t option). The web target outputs configuration to
46 file named Web.config, and the application target outputs to
47 file named application.exe.config. The any target does not have
48 a default output file.
49 If the specified config file exists, the feature will be
51 injected into it at the locations specified by mconfig configu‐
52 ration. If the target config file does not exist, it will be
53 created and will contain only the specified feature and all its
54 dependencies.
55 {defaultconfig, dc} [config_name [target_directory]]
57 Generates a default config file using the configuration entry
58 named [config_name] and outputs the resulting configuration file
59 to the directory given by the [target_directory] option. If
60 [config_name] is omitted, it defaults to Web.config for the web
61 target and application target. The any target does not specify
62 any default output configuration name. If the [target_directory]
63 parameter is omitted, it defaults to the current directory.
64 Name of the output config file created in [target_directory] is
66 given in the config file layout definition.
67
69 Config files are read in the order given below. Each subsequent file
70 may override settings found in the files read before it.
71 $prefix/etc/mono/mconfig/config.xml
73 The default configuration file, distributed with mconfig. $pre‐
74 fix is the mconfig installation prefix specified on the compila‐
75 tion time.
76 $config_dir/mconfig/config.xml
78 $config_dir is the directory specified in the XDG_CONFIG_HOME
79 environment variable or,
80 if it is empty, in the .config directory located in the user's
81 home directory. This file is not distributed with Mono.
82 ./mconfig.xml
84 Local configuration file which can contain per-application set‐
85 tings.
86
88 mconfig.config (5)
89
91 Written by Marek Habersack
92
94 Copyright (C) 2007 Novell, Inc (http://www.novell.com)
95
97 Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for
98 details.
99
101 Visit: http://www.mono-project.com for details
102 Mono(mconfig)