title: gfs2(5)

summary: GFS2 reference guide

text:
# gfs2(5)

## NAME
gfs2 - GFS2 reference guide

## SYNOPSIS
Overview of the GFS2 filesystem

## DESCRIPTION
GFS2 is a clustered filesystem, designed for sharing data between multiple nodes connected to a common shared storage device. It can also be used as a local filesystem on a single node, however since the design is aimed at clusters, that will usually result in lower performance than using a filesystem designed specifically for single node use.

GFS2 is a journaling filesystem and one journal is required for each node that will mount the filesystem. The one exception to that is spectator mounts which are equivalent to mounting a read-only block device and as such can neither recover a journal or write to the filesystem, so do not require a journal assigned to them.

The GFS2 documentation has been split into a number of sections:

mkfs.gfs2(8) Create a GFS2 filesystem

fsck.gfs2(8) The GFS2 filesystem checker

gfs2_grow(8) Growing a GFS2 filesystem

gfs2_jadd(8) Adding a journal to a GFS2 filesystem

tunegfs2(8) Tool to manipulate GFS2 superblocks

gfs2_edit(8) A GFS2 debug tool (use with caution)

## MOUNT OPTIONS
lockproto=LockProtoName

This specifies which inter-node lock protocol is used by the GFS2 filesystem for this mount, overriding the default lock protocol name stored in the filesystem's on-disk superblock. The LockProtoName must be one of the supported locking protocols, currently these are lock_nolock and lock_dlm.

The default lock protocol name is written to disk initially when creating the filesystem with mkfs.gfs2(8), -p option. It can be changed on-disk by using the tunegfs2(8) command.

The lockproto mount option should be used only under special circumstances in which you want to temporarily use a different lock protocol without changing the on-disk default. Using the incorrect lock protocol on a cluster filesystem mounted from more than one node will almost certainly result in filesystem corruption.

locktable=LockTableName

This specifies the identity of the cluster and of the filesystem for this mount, overriding the default cluster/filesystem identify stored in the filesystem's on-disk superblock. The cluster/filesystem name is recognized globally throughout the cluster, and establishes a unique namespace for the inter-node locking system, enabling the mounting of multiple GFS2 filesystems. The format of LockTableName is lock-module-specific. For lock_dlm, the format is clustername:fsname. For lock_nolock, the field is ignored.

The default cluster/filesystem name is written to disk initially when creating the filesystem with mkfs.gfs2(8), -t option. It can be changed on-disk by using the tunegfs2(8) command.

The locktable mount option should be used only under special circumstances in which you want to mount the filesystem in a different cluster, or mount it as a different filesystem name, without changing the on-disk default.

localflocks

This flag tells GFS2 that it is running as a local (not clustered) filesystem, so it can allow the kernel VFS layer to do all flock and fcntl file locking. When running in cluster mode, these file locks require inter-node locks, and require the support of GFS2. When running locally, better performance is achieved by letting VFS handle the whole job. This is turned on automatically by the lock_nolock module.

errors=[panic|withdraw]

Setting errors=panic causes GFS2 to oops when encountering an error that would otherwise cause the mount to withdraw or print an assertion warning. The default setting is errors=withdraw. This option should not be used in a production system. It replaces the earlier debug option on kernel versions 2.6.31 and above.

acl

Enables POSIX Access Control List acl(5) support within GFS2.

spectator

Mount this filesystem using a special form of read-only mount. The mount does not use one of the filesystem's journals. The node is unable to recover journals for other nodes.

norecovery

A synonym for spectator

suiddir

Sets owner of any newly created file or directory to be that of parent directory, if parent directory has S_ISUID permission attribute bit set. Sets S_ISUID in any new directory, if its parent directory's S_ISUID is set. Strips all execution bits on a new file, if parent directory owner is different from owner of process creating the file. Set this option only if you know why you are setting it.

quota=[off/account/on]

Turns quotas on or off for a filesystem. Setting the quotas to be in the "account" state causes the per UID/GID usage statistics to be correctly maintained by the filesystem, limit and warn values are ignored. The default value is "off".

discard

Causes GFS2 to generate "discard" I/O requests for blocks which have been freed. These can be used by suitable hardware to implement thin-provisioning and similar schemes. This feature is supported in kernel version 2.6.30 and above.

barrier

This option, which defaults to on, causes GFS2 to send I/O barriers when flushing the journal. The option is automatically turned off if the underlying device does not support I/O barriers. We highly recommend the use of I/O barriers with GFS2 at all times unless the block device is designed so that it cannot lose its write cache content (e.g. its on a UPS, or it doesn't have a write cache)

commit=secs

This is similar to the ext3 commit= option in that it sets the maximum number of seconds between journal commits if there is dirty data in the journal. The default is 60 seconds. This option is only provided in kernel versions 2.6.31 and above.

data=[ordered|writeback]

When data=ordered is set, the user data modified by a transaction is flushed to the disk before the transaction is committed to disk. This should prevent the user from seeing uninitialized blocks in a file after a crash. Data=writeback mode writes the user data to the disk at any time after it's dirtied. This doesn't provide the same consistency guarantee as ordered mode, but it should be slightly faster for some workloads. The default is ordered mode.

meta

This option results in selecting the meta filesystem root rather than the normal filesystem root. This option is normally only used by the GFS2 utility functions. Altering any file on the GFS2 meta filesystem may render the filesystem unusable, so only experts in the GFS2 on-disk layout should use this option.

quota_quantum=secs

This sets the number of seconds for which a change in the quota information may sit on one node before being written to the quota file. This is the preferred way to set this parameter. The value is an integer number of seconds greater than zero. The default is 60 seconds. Shorter settings result in faster updates of the lazy quota information and less likelihood of someone exceeding their quota. Longer settings make filesystem operations involving quotas faster and more efficient.

statfs_quantum=secs

Setting statfs_quantum to 0 is the preferred way to set the slow version of statfs. The default value is 30 secs which sets the maximum time period before statfs changes will be syned to the master statfs file. This can be adjusted to allow for faster, less accurate statfs values or slower more accurate values. When set to 0, statfs will always report the true values.

statfs_percent=value

This setting provides a bound on the maximum percentage change in the statfs information on a local basis before it is synced back to the master statfs file, even if the time period has not expired. If the setting of statfs_quantum is 0, then this setting is ignored.

rgrplvb

This flag tells gfs2 to look for information about a resource group's free space and unlinked inodes in its glock lock value block. This keeps gfs2 from having to read in the resource group data from disk, speeding up allocations in some cases. This option was added in the 3.6 Linux kernel. Prior to this kernel, no information was saved to the resource group lvb. Note: To safely turn on this option, all nodes mounting the filesystem must be running at least a 3.6 Linux kernel. If any nodes had previously mounted the filesystem using older kernels, the filesystem must be unmounted on all nodes before it can be mounted with this option enabled. This option does not need to be enabled on all nodes using a filesystem.

loccookie

This flag tells gfs2 to use location based readdir cookies, instead of its usual filename hash readdir cookies. The filename hash cookies are not guaranteed to be unique, and as the number of files in a directory increases, so does the likelihood of a collision. NFS requires readdir cookies to be unique, which can cause problems with very large directories (over 100,000 files). With this flag set, gfs2 will try to give out location based cookies. Since the cookie is 31 bits, gfs2 will eventually run out of unique cookies, and will fail back to using hash cookies. The maximum number of files that could have unique location cookies assuming perfectly even hashing and names of 8 or fewer characters is 1,073,741,824. An average directory should be able to give out well over half a billion location based cookies. This option was added in the 4.5 Linux kernel. Prior to this kernel, gfs2 did not add directory entries in a way that allowed it to use location based readdir cookies. Note: To safely turn on this option, all nodes mounting the filesystem must be running at least a 4.5 Linux kernel. If this option is only enabled on some of the nodes mounting a filesystem, the cookies returned by nodes using this option will not be valid on nodes that are not using this option, and vice versa. Finally, when first enabling this option on a filesystem that had been previously mounted without it, you must make sure that there are no outstanding cookies being cached by other software, such as NFS.

## SETUP
GFS2 clustering is driven by the dlm, which depends on dlm_controld to provide clustering from userspace. dlm_controld clustering is built on corosync cluster/group membership and messaging. GFS2 also requires clustered lvm which is provided by lvmlockd or, previously, clvmd. Refer to the documentation for each of these components and ensure that they are configured before setting up a GFS2 filesystem. Also refer to your distribution's documentation for any specific support requirements.

Ensure that gfs2-utils is installed on all nodes which mount the filesystem as it provides scripts required for correct withdraw event response.

1. Create the gfs2 filesystem

mkfs.gfs2 -p lock_dlm -t cluster_name:fs_name -j num /path/to/storage

The cluster_name must match the name configured in corosync (and thus dlm). The fs_name must be a unique name for the filesystem in the cluster. The -j option is the number of journals to create; there must be one for each node that will mount the filesystem.

2. Mount the gfs2 filesystem

If you are using a clustered resource manager, see its documentation for enabling a gfs2 filesystem resource. Otherwise, run:

mount /path/to/storage /mountpoint

Run "dlm_tool ls" to verify the nodes that have each fs mounted.

3. Shut down

If you are using a clustered resource manager, see its documentation for disabling a gfs2 filesystem resource. Otherwise, run:

umount -a -t gfs2

## SEE ALSO
mount(8) and umount(8) for general mount information, chmod(1) and chmod(2) for access permission flags, acl(5) for access control lists, lvm(8) for volume management, dlm_controld(8), dlm_tool(8), dlm.conf(5), corosync(8), corosync.conf(5),


ggaoed.conf

package: ggaoed

title: ggaoed.conf(5)

summary: configuration file for ggaoed

text:
# ggaoed.conf(5)

## NAME
ggaoed.conf - configuration file for ggaoed

## DESCRIPTION
This configuration file specifies the block devices that ggaoed exports using the AoE protocol.

The configuration file is organized into groups. Every group must start with the group name enclosed in square brackets. Inside a group there can be any number of key-value pairs specifying various options. Lines starting with a ‘#’ are treated as comments and are ignored.

There are two special groups named defaults and acls. The defaults group specifies global defaults, while the acls group specifies access control lists that can be referenced in device descriptions (see below).

Apart from the special groups mentioned above, there are two kinds of groups: if the name of the group matches the name of a network interface, then it contains settings for that network interface. Otherwise, it describes a device to export.

## GLOBAL DEFAULTS
The following values can be configured in the defaults group:

queue-length

The default I/O queue length of a device. There may be this many simultaneous I/O requests active. Valid values are between 1 and 65535. The default is 64.

direct-io

If set to true, then devices will use direct I/O by default. Note that whether direct I/O will improve or reduce performance depends on a lot of factors. Valid values are true and false. The default value is true.

trace-io

If set to true, then all I/O requests received by the daemon will be logged. Note that this may produce a huge volume of messages on a heavy used server so this option should only be enabled for debugging purposes. Valid values are true and false. The default value is false.

interfaces

Comma-separated list of network interfaces where the daemon should listen on. The shell-like glob characters ‘?’ and ‘*’ are also allowed. If this parameter is not defined, ggaoed will listen on all up and running Ethernet interfaces.

mtu

Force the specified MTU rather than the auto-detected value. Note that you can only lower the MTU this way.

ring-buffer-size

Size of the ring buffer for sending and receiving packets combined, in KiB. Note that these buffers are allocated from unswappable kernel memory. The default value is 4096. Setting this value to 0 disables the memory-mapped ring buffer and forces ggaoed to use traditional recvmsg() and sendmsg() calls.

send-buffer-size

Size of the in-kernel socket buffer for sending data, in KiB. It is relevant only if the ring buffer is disabled. Note that this value is only a hint; check the logs if you want to know the real value being used.

receive-buffer-size

Size of the in-kernel socket buffer for receiving data, in KiB. It is relevant only if the ring buffer is disabled. Note that this value is only a hint; check the logs if you want to know the real value being used.

max-delay

When merging I/O requests, requests that have earlier may get repeatedly pushed at the end of the queue. This value specifies the bound for how long that can happen. The value should be a floating point number between 0 and 1.

merge-delay

When not zero, I/O submission will be delayed after receiving a request anticipating more requests to merge together. The value should be a floating point number between 0 and 1. The default is 0.

pid-file

The location of the pid file. The default value is /var/run/ggaoed.conf.

control-socket

The location of the control socket used by ggaoectl. The default value is /var/run/ggaoed.sock.

state-directory

The directory where persistent information (AoE configuration space, MAC mask list and reservation list) is stored. The default value is /var/ggaoed.

Example:

```
[defaults]
interfaces = eth2, vlan*
queue-length = 256

```

## ACL DEFINITIONS
Important ACLs are not a security feature. If someone can send you an AoE request then he/she can also forge the source address to circumvent ACLs. On the other hand, ACLs can protect you and your data from accidental misconfiguration of AoE initiators (clients).

The acls group defines named access control lists that in turn can be referenced in device configuration groups. The group contains key-value pairs, where the key is the name of the defined ACL, and the value is a comma-separated list of addresses. The following addresses are recognized:

MAC address

Hardware ethernet address having the form XX:XX:XX:XX:XX:XX, where X stands for a hexadecimal digit.

A previously defined ACL

The value may be the name of a previously defined ACL. In this case the list of addresses defined by that ACL is appended to the current ACL.

Symbolic name

If a value cannot be interpreted by the above rules, then it is looked up in /etc/ethers.

Example:

```
[acls]
acl1 = de:ad:be:ef:00:01, de:ad:be:ef:00:02
acl2 = de:ad:be:ef:01:01, de:ad:be:ef:01:02
# Reference existing ACLs
acl3 = acl1, acl2
# Look up the MAC address in /etc/ethers
acl4 = somehost

```

An ACL can contain at most 255 entries. If the ACL definition resolves to more entries, then only the first 255 will be used.

## NETWORK INTERFACE CONFIGURATION
If the name of a group matches the name of a network interface, then it describes configuration for that interface. The following options may be specified:

mtu

Force the specified MTU rather than the auto-detected value. Note that you can only lower the MTU this way.

ring-buffer-size

Size of the ring buffer for receiving packets, in KiB. Note that these buffers are allocated from unswappable kernel memory. The default value is 4096. Setting this value to 0 disables the memory-mapped ring buffer and forces ggaoed to use traditional sendmsg() and recvmsg() calls.

send-buffer-size

Size of the in-kernel socket buffer for sending data, in KiB. It is relevant only if the ring buffer is disabled. Note that this value is only a hint; check the logs if you want to know the real value being used.

receive-buffer-size

Size of the in-kernel socket buffer for receiving data, in KiB. It is relevant only if the ring buffer is disabled. Note that this value is only a hint; check the logs if you want to know the real value being used.

Example:

```
[eth0]
mtu = 4200

```

## DISK DEVICE CONFIGURATION
If a group does not fall into the above categories, then it is interpreted as a disk device definition. In this case the name of the group is not really important except that it must be unique and it will be used for logging. The following options may be specified for a disk device:

path

Path of the block device or file to export. It cannot be used together with the uuid option. Specifying exactly one of the path and uuid options is mandatory.

uuid

UUID of the device to export. It cannot be used together with the path option. If the uuid option is specified, then all known block devices are scanned, and the one that has a known content with a matching UUID will be used. Devices that can be identified in this way include MD (software RAID) devices, LVM logical volumes, swap partitions, or any block device that contains a valid file system that supports UUIDs.

shelf

The AoE shelf address of the device. Specifying it is mandatory.

slot

The AoE slot address of the device. Specifying it is mandatory. The shelf/slot pair must be unique between configured devices.

queue-length

The number of I/O operations that can be queued simultaneously.

max-delay

When merging I/O requests, requests that have earlier may get repeatedly pushed at the end of the queue. This value specifies the bound for how long that can happen. The value should be a floating point number between 0 and 1.

merge-delay

When not zero, I/O submission will be delayed after receiving a request anticipating more requests to merge together. The value should be a floating point number between 0 and 1.

direct-io

If set to true, then the device will be opened using O_DIRECT. If set to false, buffered I/O will be used for this device.

trace-io

If set to true, then all I/O requests received by the daemon will be logged. Note that this may produce a huge volume of messages on a heavy used server so this option should only be enabled for debugging purposes. The default value is false. Setting this option to false in the per-device section disables I/O tracing even if the -d option was passed to ggaoed.

read-only

If set to true, the device or file will be opened in read-only mode, and all write operations to it will fail. The default is false.

interfaces

A comma-separated list of interfaces where the device should be exported. If not specified, the device can be accessed on all interfaces the daemon listens on.

accept

A comma-separated list of ACL entries where the device is allowed to receive commands from. See the description of the acls group on how the list is interpreted. If the accept option is missing, the device accepts commands from all clients. If the accept option defines a non-empty list, then only clients whose MAC address is part of the ACL will be allowed access.

deny

A comma-separated list of ACL entries where the device should not accept commands from. This ACL is evaluated after the accept ACL.

broadcast

By default, the existence of the device will be broadcasted on all interfaces defined by the interfaces option. However, if the accept option specifies a non-empty ACL, then the presence of the device will be announced only to the hosts whose MAC address is part of the ACL. Setting this option to true reverts this behaviour. This can be used to reduce traffic if the accept ACL contains a large number of addresses.

Example:

```
[sdc]
path = /dev/sdc
shelf = 0
slot = 0
accept = acl3
broadcast = true
read-only = true
[somedisk]
uuid = 01234567-89ab-cdef-0123-456789abcdef
shelf = 0
slot = 1
queue-length = 64

```

## SEE ALSO
ggaoed(8), ggaoectl(8)

## AUTHOR
Gábor Gombás <gombasg@digikabel.hu>


ggz.modules

package: ggz-base-libs

title: ggz.modules(5)

text:
# ggz.modules(5)

## NAME
ggz.modules - GGZ Gaming Zone module configuration file

## DESCRIPTION
The GGZ Gaming Zone uses the file ggz.modules in order to configure which game modules are properly installed. The only approved method of altering this file is using the ggz-config utility, however the file structure is documented here in order to facilitate manual repairs if necessary.

## PARAMETERS
The ggz.modules file is formattted in sections, each of which begins with a [SectionID] line. The first (required) section is [Games]. This section is followed by any number of game-specific sections named [g#].

The [Games] section is formatted as follows:

[Games]

*GameList* = GameName1 GameName2 ...

GameName1 = g1 g2 ...

GameName2 = g3 ...

*GameList*

Should be set to a list of all the game names which are currently installed. Each name should appear once and only once, and should be the internal game name (eg: NetSpades) and not the full descriptive name of the game.

GameNameX

Should equal a game name from the *GameList*, a real world example would be NetSpades. It should be set to a list of unique game section ID's of the form g#. Each game section ID must be the name of a section ID which follows in the file. The ID's need not be in any specific order, and ID numbers may be skipped but NOT repeated.

A game section is formatted as follows:

[g#]

Author = Game's Author

CommandLine = /path/to/command [optionlist]

Frontend = FECODE

Homepage = URL to Game's homepage

Name = GameName

Protocol = ProtocolVersion

Version = GameVersion

Most of these parameters are self explanatory, however the following may need clarification:

[g#]

This section code ID must be present in one of the game lists in the [Games] section above.

FECODE

The frontend code should be set to either gtk or kde depending on which user interface the game was designed for. Note that the game is expected to work with either the GTK+ or KDE clients, assuming that the user has the proper windowing system installed.

GameName

This must equal the game name (in the [Games] section) which properly points to this [g#] section.

ProtocolVersion

This will be used to match an installed game client with the protocol version currently used by the game server. This allows a new game client to be installed, while retaining the old client for backwards compatibility with older servers.

GameVersion

This is simply the version of the game client itself. It need not be the same version as the game server as long as the ProtocolVersion ID matches.

## FILES
@ggzconfdir@/ggz.modules

## AUTHORS
The GGZ Development Team <ggz-dev@mail.ggzgamingzone.org>

## SEE ALSO
ggz-config(6), ggz(7)


package: gimp

title: gimprc-3.2(5)

summary: gimp configuration file

text:
# gimprc-3.2(5)

## NAME
gimprc - gimp configuration file

## DESCRIPTION
The gimprc file is a configuration file read by GIMP when it starts up. There are two of these: one system-wide one stored in /etc/gimp/3.0/gimprc and a per-user $XDG_CONFIG_HOME/gimp/3.2/gimprc which may override system settings.

Comments are introduced by a hash sign (#), and continue until the end of the line. Blank lines are ignored.

The gimprc file associates values with properties. These properties may be set by lisp-like assignments of the form:

(property-name value)

where:

property-name

is one of the property names described below.

value

is the value the property is to be set to.

Either spaces or tabs may be used to separate the name from the value.

## PROPERTIES
Valid properties and their default values are:

(temp-path "${gimp_temp_dir}")

Sets the folder for temporary storage. Files will appear here during the course of running GIMP. Most files will disappear when GIMP exits, but some files are likely to remain, so it is best if this folder not be one that is shared by other users. This is a single folder.

(swap-path "${gimp_cache_dir}")

Sets the swap file location. GIMP uses a tile based memory allocation scheme. The swap file is used to quickly and easily swap tiles out to disk and back in. Be aware that the swap file can easily get very large if GIMP is used with large images. Also, things can get horribly slow if the swap file is created on a folder that is mounted over NFS. For these reasons, it may be desirable to put your swap file in "/tmp". This is a single folder.

(swap-compression "fast")

The compression method used for tile data stored in the swap file. This is a string value.

(num-processors 1)

Sets how many threads GIMP should use for operations that support it. This is an integer value.

(tile-cache-size 2g)

When the amount of pixel data exceeds this limit, GIMP will start to swap tiles to disk. This is a lot slower but it makes it possible to work on images that wouldn't fit into memory otherwise. If you have a lot of RAM, you may want to set this to a higher value. The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix is specified the size defaults to being specified in bytes.

(use-opencl no)

When enabled, uses OpenCL for some operations. Possible values are yes and no.

Specifies the language to use for the user interface. This is a string value.

Specifies the language the user interface was previously displayed in. This

is a string value.

The version of GIMP config files. This is a string value.

(interpolation-type cubic)

Sets the level of interpolation used for scaling and other transformations. Possible values are none, linear, cubic, nohalo and lohalo.

(default-threshold 15)

Tools such as fuzzy-select and bucket fill find regions based on a seed-fill algorithm. The seed fill starts at the initially selected pixel and progresses in all directions until the difference of pixel intensity from the original is greater than a specified threshold. This value represents the default threshold. This is an integer value.

(plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")

Sets the plug-in search path. This is a colon-separated list of folders to search.

(module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")

Sets the module search path. This is a colon-separated list of folders to search.

(interpreter-path "${gimp_dir}/interpreters:${gimp_plug_in_dir}/interpreters")

Sets the interpreter search path. This is a colon-separated list of folders to search.

(environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")

Sets the environ search path. This is a colon-separated list of folders to search.

(brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")

Sets the brush search path. This is a colon-separated list of folders to search.

(brush-path-writable "${gimp_dir}/brushes")

This is a colon-separated list of folders to search.

(dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")

Sets the dynamics search path. This is a colon-separated list of folders to search.

(dynamics-path-writable "${gimp_dir}/dynamics")

This is a colon-separated list of folders to search.

(mypaint-brush-path "/usr/share/mypaint-data/2.0/brushes:~/.mypaint/brushes")

Sets the brush search path. This is a colon-separated list of folders to search.

(mypaint-brush-path-writable "~/.mypaint/brushes")

This is a colon-separated list of folders to search.

(pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")

Sets the pattern search path. This is a colon-separated list of folders to search.

(pattern-path-writable "${gimp_dir}/patterns")

This is a colon-separated list of folders to search.

(palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")

Sets the palette search path. This is a colon-separated list of folders to search.

(palette-path-writable "${gimp_dir}/palettes")

This is a colon-separated list of folders to search.

(gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")

Sets the gradient search path. This is a colon-separated list of folders to search.

(gradient-path-writable "${gimp_dir}/gradients")

This is a colon-separated list of folders to search.

(tool-preset-path "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-presets")

Sets the dynamics search path. This is a colon-separated list of folders to search.

(tool-preset-path-writable "${gimp_dir}/tool-presets")

This is a colon-separated list of folders to search.

(font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")

Where to look for fonts in addition to the system-wide installed fonts. This is a colon-separated list of folders to search.

(default-brush "2. Hardness 050")

Specify a default brush. The brush is searched for in the specified brush path. This is a string value.

(default-dynamics "Pressure Size")

Specify a default dynamics. The dynamics is searched for in the specified dynamics path. This is a string value.

(default-mypaint-brush "Fixme")

Specify a default MyPaint brush. This is a string value.

(default-pattern "Pine")

Specify a default pattern. This is a string value.

(default-palette "Default")

Specify a default palette. This is a string value.

(default-gradient "FG to BG (RGB)")

Specify a default gradient. This is a string value.

(default-tool-preset "Current Options")

Specify a default tool preset. The tool preset is searched for in the specified tool presets path. This is a string value.

(default-font "Sans-serif")

Specify a default font. This is a string value.

(global-brush yes)

When enabled, the selected brush will be used for all tools. Possible values are yes and no.

(global-dynamics yes)

When enabled, the selected dynamics will be used for all tools. Possible values are yes and no.

(global-pattern yes)

When enabled, the selected pattern will be used for all tools. Possible values are yes and no.

(global-palette yes)

When enabled, the selected palette will be used for all tools. Possible values are yes and no.

(global-gradient yes)

When enabled, the selected gradient will be used for all tools. Possible values are yes and no.

(global-font yes)

When enabled, the selected font will be used for all tools. Possible values are yes and no.

(global-expand yes)

When enabled, the selected auto expand layer settings will be used for all tools. Possible values are yes and no.

(default-image

(width 1920)

(height 1080)

(unit pixels)

(xresolution 300)

(yresolution 300)

(resolution-unit inches)

(image-type rgb)

(precision u8-non-linear)

(color-profile NULL)

(simulation-profile NULL)

(simulation-bpc no)

(simulation-intent relative-colorimetric)

(fill-type background)

(comment "Created with GIMP")) Sets the default image in the "File/New" dialog. This is a parameter list.

(default-grid

(style solid)

(fgcolor

(color "R'G'B'A float" 16 " 20077" 0))

(bgcolor

(color "R'G'B'A float" 16 " 20077 20077 20077 20077" 0))

(xspacing 10)

(yspacing 10)

(spacing-unit inches)

(xoffset 0)

(yoffset 0)

(offset-unit inches)) Specify a default image grid. This is a parameter list.

(undo-levels 5)

Sets the minimal number of operations that can be undone. More undo levels are kept available until the undo-size limit is reached. This is an integer value.

(undo-size 1g)

Sets an upper limit to the memory that is used per image to keep operations on the undo stack. Regardless of this setting, at least as many undo-levels as configured can be undone. The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix is specified the size defaults to being specified in bytes.

(undo-preview-size large)

Sets the size of the previews in the Undo History. Possible values are tiny, extra-small, small, medium, large, extra-large, huge, enormous and gigantic.

(plug-in-history-size 10)

How many recently used filters and plug-ins to keep on the Filters menu. This is an integer value.

(pluginrc-path "${gimp_dir}/pluginrc")

Sets the pluginrc search path. This is a single filename.

(layer-previews yes)

Sets whether GIMP should create previews of layers and channels. Previews in the layers and channels dialog are nice to have but they can slow things down when working with large images. Possible values are yes and no.

(group-layer-previews yes)

Sets whether GIMP should create previews of layer groups. Layer group previews are more expensive than ordinary layer previews. Possible values are yes and no.

(layer-preview-size medium)

Sets the preview size used for layers and channel previews in newly created dialogs. Possible values are tiny, extra-small, small, medium, large, extra-large, huge, enormous and gigantic.

(thumbnail-size normal)

Sets the size of the thumbnail shown in the Open dialog. Possible values are none, normal and large.

(thumbnail-filesize-limit 4M)

The thumbnail in the Open dialog will be automatically updated if the file being previewed is smaller than the size set here. The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix is specified the size defaults to being specified in bytes.

(color-management

(mode display)

(display-profile-from-gdk no)

(display-rendering-intent relative-colorimetric)

(display-use-black-point-compensation yes)

(display-optimize yes)

(simulation-rendering-intent perceptual)

(simulation-use-black-point-compensation no)

(simulation-optimize yes)

(simulation-gamut-check no)

(out-of-gamut-color

(color "RGBA float" 16 " 20077 20077 20077" 0))

(show-rgb-u8 no)

(show-hsv no)) Defines the color management behavior. This is a parameter list.

(save-document-history yes)

Keep a permanent record of all opened and saved files in the Recent Documents list. Possible values are yes and no.

(quick-mask-color

(color "R'G'B'A float" 16 " 20077 77" 0)) Sets the default quick mask color. The color is specified as opaque GeglColor (any Alpha channel is ignored).

(import-promote-float no)

Promote imported images to floating point precision. Does not apply to indexed images. Possible values are yes and no.

(import-promote-dither yes)

When promoting imported images to floating point precision, also add minimal noise in order to distribute color values a bit. Possible values are yes and no.

(import-add-alpha no)

Add an alpha channel to all layers of imported images. Possible values are yes and no.

(import-raw-plug-in "")

Which plug-in to use for importing raw digital camera files. This is a single filename.

(export-file-type png)

Export file type used by default. Possible values are png, jpg, ora, psd, pdf, tif, bmp and webp.

(export-color-profile yes)

Export the image's color profile by default. Possible values are yes and no.

(export-comment yes)

Export the image's comment by default. Possible values are yes and no.

(export-thumbnail yes)

Export the image's thumbnail by default Possible values are yes and no.

(export-metadata-exif yes)

Export Exif metadata by default. Possible values are yes and no.

(export-metadata-xmp yes)

Export XMP metadata by default. Possible values are yes and no.

(export-metadata-iptc yes)

Export IPTC metadata by default. Possible values are yes and no.

(export-update-metadata yes)

When enabled, add and update metadata automatically. When disabled, only the minimum necessary metadata changes are made, without changing modification date, synchronizing tags, or updating the software and change history metadata. Possible values are yes and no.

(debug-policy fatal)

Try generating debug data for bug reporting when appropriate. Possible values are warning, critical, fatal and never.

(check-updates yes)

Check for availability of GIMP updates through background internet queries. Possible values are yes and no.

(check-update-timestamp 0)

Timestamp of the last update check. This is an integer value.

(last-release-timestamp 0)

The timestamp for the last known release date. This is an integer value.

The comment for the last known release. This is a string value.

(last-revision 0)

The last revision number for the release. This is an integer value.

The last known release version of GIMP as queried from official website. This

is a string value.

(items-select-method plain-text)

Sets how items are searched and selected from a textual pattern. Possible values are plain-text, regex-pattern and glob-pattern.

(transparency-size medium-checks)

Sets the size of the checkerboard used to display transparency. Possible values are small-checks, medium-checks and large-checks.

(transparency-type gray-checks)

Sets the manner in which transparency is displayed in images. Possible values are light-checks, gray-checks, dark-checks, white-only, gray-only, black-only and custom-checks.

(transparency-custom-color1

(color "R'G'B'A double" 32 "636363636363343776363636363633437763636363636334377 36077" 0)) The first color to use in the transparency checkerboard, when Transparency Type is set to Custom colors. The color is specified as GeglColor.

(transparency-custom-color2

(color "R'G'B'A double" 32 "232231231231231231331772322312312312312313317723223123123123123133177 36077" 0)) The second color to use in the transparency checkerboard, when Transparency Type is set to Custom colors. The color is specified as GeglColor.

(snap-distance 8)

This is the distance in pixels where Guide and Grid snapping activates. This is an integer value.

(marching-ants-speed 200)

Speed of marching ants in the selection outline. This value is in milliseconds (less time indicates faster marching). This is an integer value.

(resize-windows-on-zoom no)

When enabled, the image window will automatically resize itself when zooming into and out of images. This setting only takes effect in multi-window mode. Possible values are yes and no.

(resize-windows-on-resize no)

When enabled, the image window will automatically resize itself whenever the physical image size changes. This setting only takes effect in multi-window mode. Possible values are yes and no.

(default-show-all no)

Show full image content by default. Possible values are yes and no.

(default-dot-for-dot yes)

When enabled, this will ensure that each pixel of an image gets mapped to a pixel on the screen. Possible values are yes and no.

(initial-zoom-to-fit yes)

When enabled, this will ensure that the full image is visible after a file is opened, otherwise it will be displayed with a scale of 1:1. Possible values are yes and no.

(drag-zoom-mode distance)

Whether to zoom based on distance moved or time spent moving, when zooming via dragging the mouse. Possible values are distance and duration.

(drag-zoom-speed 100)

Adjusts the rate at which dragging the mouse will zoom the canvas, in percentage. This is a float value.

(cursor-mode tool-crosshair)

Sets the type of mouse pointers to use. Possible values are tool-icon, tool-crosshair and crosshair.

(cursor-updating yes)

Context-dependent mouse pointers are helpful. They are enabled by default. However, they require overhead that you may want to do without. Possible values are yes and no.

(show-brush-outline yes)

When enabled, all paint tools will show a preview of the current brush's outline. Possible values are yes and no.

(snap-brush-outline no)

When enabled, the brush outline will snap to individual dabs while painting. Possible values are yes and no.

(show-paint-tool-cursor yes)

When enabled, the pointer will be shown over the image while using a paint tool. If both the brush outline and pointer are disabled, the position will be indicated as unobtrusively as possibly. Possible values are yes and no.

(image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")

Sets the text to appear in image window titles. This is a format string; certain % character sequences are recognised and expanded as follows:

%% literal percent sign

%f bare filename, or "Untitled"

%F full path to file, or "Untitled"

%p PDB image id

%i view instance number

%t image type (RGB, grayscale, indexed)

%z zoom factor as a percentage

%s source scale factor

%d destination scale factor

%Dx expands to x if the image is dirty, the empty string otherwise

%Cx expands to x if the image is clean, the empty string otherwise

%B expands to (modified) if the image is dirty, the empty string otherwise

%A expands to (clean) if the image is clean, the empty string otherwise

%Nx expands to x if the image is export-dirty, the empty string otherwise

%Ex expands to x if the image is export-clean, the empty string otherwise

%l the number of layers

%L the number of layers (long form)

%m memory used by the image

%n the name of the active layer/channel

%P the PDB id of the active layer/channel

%w image width in pixels

%W image width in real-world units

%h image height in pixels

%H image height in real-world units

%M the image size expressed in megapixels

%u unit symbol

%U unit abbreviation

%x the width of the active layer/channel in pixels

%X the width of the active layer/channel in real-world units

%y the height of the active layer/channel in pixels

%Y the height of the active layer/channel in real-world units

%o the name of the image's color profile

(image-status-format "%n (%m)")

Sets the text to appear in image window status bars. This is a format string; certain % character sequences are recognised and expanded as follows:

%% literal percent sign

%f bare filename, or "Untitled"

%F full path to file, or "Untitled"

%p PDB image id

%i view instance number

%t image type (RGB, grayscale, indexed)

%z zoom factor as a percentage

%s source scale factor

%d destination scale factor

%Dx expands to x if the image is dirty, the empty string otherwise

%Cx expands to x if the image is clean, the empty string otherwise

%B expands to (modified) if the image is dirty, the empty string otherwise

%A expands to (clean) if the image is clean, the empty string otherwise

%Nx expands to x if the image is export-dirty, the empty string otherwise

%Ex expands to x if the image is export-clean, the empty string otherwise

%l the number of layers

%L the number of layers (long form)

%m memory used by the image

%n the name of the active layer/channel

%P the PDB id of the active layer/channel

%w image width in pixels

%W image width in real-world units

%h image height in pixels

%H image height in real-world units

%M the image size expressed in megapixels

%u unit symbol

%U unit abbreviation

%x the width of the active layer/channel in pixels

%X the width of the active layer/channel in real-world units

%y the height of the active layer/channel in pixels

%Y the height of the active layer/channel in real-world units

%o the name of the image's color profile

(monitor-xresolution 96)

Sets the monitor's horizontal resolution, in dots per inch. If set to 0, forces the X server to be queried for both horizontal and vertical resolution information. This is a float value.

(monitor-yresolution 96)

Sets the monitor's vertical resolution, in dots per inch. If set to 0, forces the X server to be queried for both horizontal and vertical resolution information. This is a float value.

(monitor-resolution-from-windowing-system yes)

When enabled, GIMP will use the monitor resolution from the windowing system. Possible values are yes and no.

(navigation-preview-size medium)

Sets the size of the navigation preview available in the lower right corner of the image window. Possible values are tiny, extra-small, small, medium, large, extra-large, huge, enormous and gigantic.

(default-view

(show-menubar yes)

(show-statusbar yes)

(show-rulers yes)

(show-scrollbars yes)

(show-selection yes)

(show-layer-boundary yes)

(show-canvas-boundary yes)

(show-guides yes)

(show-grid no)

(show-sample-points yes)

(snap-to-guides yes)

(snap-to-grid no)

(snap-to-canvas no)

(snap-to-path no)

(snap-to-bbox no)

(snap-to-equidistance no)

(padding-mode default)

(padding-color

(color "R'G'B'A float" 16 " 20077 20077 20077 20077" 0))

(padding-in-show-all no)) Sets the default settings for the image view. This is a parameter list.

(default-fullscreen-view

(show-menubar yes)

(show-statusbar yes)

(show-rulers yes)

(show-scrollbars yes)

(show-selection yes)

(show-layer-boundary yes)

(show-canvas-boundary yes)

(show-guides yes)

(show-grid no)

(show-sample-points yes)

(snap-to-guides yes)

(snap-to-grid no)

(snap-to-canvas no)

(snap-to-path no)

(snap-to-bbox no)

(snap-to-equidistance no)

(padding-mode default)

(padding-color

(color "R'G'B'A float" 16 " 20077 20077 20077 20077" 0))

(padding-in-show-all no)) Sets the default settings used when an image is viewed in fullscreen mode. This is a parameter list.

(activate-on-focus yes)

When enabled, an image will become the active image when its image window receives the focus. This is useful for window managers using "click to focus".

Possible values are yes and no.

(space-bar-action pan)

What to do when the space bar is pressed in the image window. Possible values are none, pan and move.

(zoom-quality high)

There's a tradeoff between speed and quality of the zoomed-out display. Possible values are low and high.

(use-event-history no)

Bugs in event history buffer are frequent so in case of cursor offset problems turning it off helps. Possible values are yes and no.

(edit-non-visible no)

When enabled, non-visible layers can be edited as normal. Possible values are yes and no.

(move-tool-changes-active no)

If enabled, the move tool sets the edited layer or path as active. This used to be the default behavior in older versions. Possible values are yes and no.

(filter-tool-max-recent 10)

How many recent settings to keep around in filter tools. This is an integer value.

(filter-tool-use-last-settings no)

Default to the last used settings in filter tools. Possible values are yes and no.

(trust-dirty-flag no)

When enabled, GIMP will not save an image if it has not been changed since it was opened. Possible values are yes and no.

(save-device-status yes)

Remember the current tool, pattern, color, and brush across GIMP sessions. Possible values are yes and no.

(devices-share-tool no)

When enabled, the same tool and tool options will be used for all input devices. No tool switching will occur when the input device changes. Possible values are yes and no.

(save-session-info yes)

Save the positions and sizes of the main dialogs when GIMP exits. Possible values are yes and no.

(restore-session yes)

Let GIMP try to restore your last saved session on each startup. Possible values are yes and no.

(restore-monitor no)

When enabled, GIMP will try to restore windows on the monitor they were open before. When disabled, windows will appear on the currently used monitor. Possible values are yes and no.

(save-tool-options yes)

Save the tool options when GIMP exits. Possible values are yes and no.

(can-change-accels no)

When enabled, you can change keyboard shortcuts for menu items by hitting a key combination while the menu item is highlighted. Possible values are yes and no.

(save-accels yes)

Save changed keyboard shortcuts when GIMP exits. Possible values are yes and no.

(restore-accels yes)

Restore saved keyboard shortcuts on each GIMP startup. Possible values are yes and no.

(last-opened-size 10)

How many recently opened image filenames to keep on the File menu. This is an integer value.

(max-new-image-size 128M)

GIMP will warn the user if an attempt is made to create an image that would take more memory than the size specified here. The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix is specified the size defaults to being specified in bytes.

(toolbox-color-area yes)

Show the current foreground and background colors in the toolbox. Possible values are yes and no.

(toolbox-foo-area no)

Show the currently selected brush, pattern and gradient in the toolbox. Possible values are yes and no.

(toolbox-image-area no)

Show the currently active image in the toolbox. Possible values are yes and no.

(toolbox-wilber yes)

Show the GIMP mascot at the top of the toolbox. Possible values are yes and no.

(toolbox-groups yes)

Use a single toolbox button for grouped tools. Possible values are yes and no.

(theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")

Sets the theme search path. This is a colon-separated list of folders to search.

(theme "Default")

The name of the theme to use. This is a string value.

(theme-color-scheme dark)

Chooses the color scheme variant of the theme. Possible values are light, gray, dark and system.

(override-theme-icon-size no)

Override theme-set icon sizes. Possible values are yes and no.

(custom-icon-size medium)

The size of the icons to use. Possible values are small, medium, large and huge.

(viewables-follow-theme no)

Use theme colors for preview Possible values are yes and no.

(icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")

Sets the icon theme search path. This is a colon-separated list of folders to search.

(icon-theme "Default")

The name of the icon theme to use. This is a string value.

(prefer-symbolic-icons yes)

When enabled, symbolic icons will be preferred if available. Possible values are yes and no.

(font-relative-size 1)

Tweak font size of the graphical interface. This is a float value.

(use-help yes)

When enabled, pressing F1 will open the help browser. Possible values are yes and no.

(show-help-button yes)

When enabled, dialogs will show a help button that gives access to the related help page. Without this button, the help page can still be reached by pressing F1. Possible values are yes and no.

(help-locales "")

Specifies the language preferences used by the help system. This is a colon-separated list of language identifiers with decreasing priority. If empty, the language is taken from the user's locale setting. This is a string value.

(help-browser web-browser)

Sets the browser used by the help system. Possible values are gimp and web-browser.

(action-history-size 100)

The maximum number of actions saved in history. This is an integer value.

(user-manual-online no)

When enabled, the online user manual will be used by the help system. Otherwise the locally installed copy is used. Possible values are yes and no.

(user-manual-online-uri "https://docs.gimp.org/3.2")

The location of the online user manual. This is used if 'user-manual-online' is enabled. This is a string value.

(dock-window-hint utility)

The window type hint that is set on dock windows and the toolbox window. This may affect the way your window manager decorates and handles these windows. Possible values are normal, utility and keep-above.

(cursor-handedness right)

Sets the handedness for cursor positioning. Possible values are left and right.

(custom-title-bar no)

Merge menu and title bar (client-side decoration) Possible values are yes and no.

(playground-npd-tool no)

Enable the N-Point Deformation tool. Possible values are yes and no.

(playground-seamless-clone-tool no)

Enable the Seamless Clone tool. Possible values are yes and no.

(playground-paint-select-tool no)

Enable the Paint Select tool. Possible values are yes and no.

(playground-use-list-box no)

Use the new GtkListBox widget for simple lists. Possible values are yes and no.

(show-welcome-dialog yes)

Show a welcome dialog when GIMP starts. Possible values are yes and no.

(color-profile-policy ask)

What to do when opening a file with an embedded ICC color profile. Possible values are ask, keep, convert-builtin and convert-preferred.

(metadata-rotation-policy ask)

How to handle "Orientation" metadata when opening a file. Possible values are ask, keep and rotate.

Sets the default folder path for all color profile file dialogs. This is a

single filename.

(image-convert-profile-intent relative-colorimetric)

Sets the default rendering intent for the 'Convert to Color Profile' dialog. Possible values are perceptual, relative-colorimetric, saturation and absolute-colorimetric.

(image-convert-profile-black-point-compensation yes)

Sets the default 'Black Point Compensation' state for the 'Convert to Color Profile' dialog. Possible values are yes and no.

(image-convert-precision-layer-dither-method none)

Sets the default layer dithering method for the 'Convert Precision' dialog. Possible values are none, floyd-steinberg, bayer, random, random-covariant, add, add-covariant, xor, xor-covariant, blue-noise and blue-noise-covariant.

(image-convert-precision-text-layer-dither-method none)

Sets the default text layer dithering method for the 'Convert Precision' dialog. Possible values are none, floyd-steinberg, bayer, random, random-covariant, add, add-covariant, xor, xor-covariant, blue-noise and blue-noise-covariant.

(image-convert-precision-channel-dither-method none)

Sets the default channel dithering method for the 'Convert Precision' dialog. Possible values are none, floyd-steinberg, bayer, random, random-covariant, add, add-covariant, xor, xor-covariant, blue-noise and blue-noise-covariant.

(image-convert-indexed-palette-type generate)

Sets the default palette type for the 'Convert to Indexed' dialog. Possible values are generate, web, mono and custom.

(image-convert-indexed-max-colors 256)

Sets the default maximum number of colors for the 'Convert to Indexed' dialog.

This is an integer value.

(image-convert-indexed-remove-duplicates yes)

Sets the default 'Remove duplicate colors' state for the 'Convert to Indexed' dialog. Possible values are yes and no.

(image-convert-indexed-dither-type none)

Sets the default dithering type for the 'Convert to Indexed' dialog. Possible values are none, fs, fs-lowbleed and fixed.

(image-convert-indexed-dither-alpha no)

Sets the default 'Dither alpha' state for the 'Convert to Indexed' dialog. Possible values are yes and no.

(image-convert-indexed-dither-text-layers no)

Sets the default 'Dither text layers' state for the 'Convert to Indexed' dialog. Possible values are yes and no.

(image-resize-fill-type transparent)

Sets the default fill type for the 'Canvas Size' dialog. Possible values are foreground, background, cielab-middle-gray, white, transparent and pattern.

(image-resize-layer-set none)

Sets the default set of layers to resize for the 'Canvas Size' dialog. Possible values are none, all, image-sized and visible.

(image-resize-resize-text-layers no)

Sets the default 'Resize text layers' state for the 'Canvas Size' dialog. Possible values are yes and no.

(layer-new-name "Layer")

Sets the default layer name for the 'New Layer' dialog. This is a string value.

(layer-new-mode normal)

Sets the default mode for the 'New Layer' dialog. Possible values are normal-legacy, dissolve, behind-legacy, multiply-legacy, screen-legacy, overlay-legacy, difference-legacy, addition-legacy, subtract-legacy, darken-only-legacy, lighten-only-legacy, hsv-hue-legacy, hsv-saturation-legacy, hsl-color-legacy, hsv-value-legacy, divide-legacy, dodge-legacy, burn-legacy, hardlight-legacy, softlight-legacy, grain-extract-legacy, grain-merge-legacy, color-erase-legacy, overlay, lch-hue, lch-chroma, lch-color, lch-lightness, normal, behind, multiply, screen, difference, addition, subtract, darken-only, lighten-only, hsv-hue, hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hardlight, softlight, grain-extract, grain-merge, vivid-light, pin-light, linear-light, hard-mix, exclusion, linear-burn, luma-darken-only, luma-lighten-only, luminance, color-erase, erase, merge, split, pass-through, replace, overwrite and anti-erase.

(layer-new-blend-space auto)

Sets the default blend space for the 'New Layer' dialog. Possible values are auto, rgb-linear, rgb-non-linear, lab and rgb-perceptual.

(layer-new-composite-space auto)

Sets the default composite space for the 'New Layer' dialog. Possible values are auto, rgb-linear, rgb-non-linear, lab and rgb-perceptual.

(layer-new-composite-mode auto)

Sets the default composite mode for the 'New Layer' dialog. Possible values are auto, union, clip-to-backdrop, clip-to-layer and intersection.

(layer-new-opacity 1)

Sets the default opacity for the 'New Layer' dialog. This is a float value.

(layer-new-fill-type transparent)

Sets the default fill type for the 'New Layer' dialog. Possible values are foreground, background, cielab-middle-gray, white, transparent and pattern.

(layer-resize-fill-type transparent)

Sets the default fill type for the 'Layer Boundary Size' dialog. Possible values are foreground, background, cielab-middle-gray, white, transparent and pattern.

(layer-add-mask-type white)

Sets the default mask for the 'Add Layer Mask' dialog. Possible values are white, black, alpha, alpha-transfer, selection, copy and channel.

(layer-add-mask-invert no)

Sets the default 'invert mask' state for the 'Add Layer Mask' dialog. Possible values are yes and no.

(layer-add-mask-edit-mask yes)

Sets the default 'edit mask' state for the 'Add Layer Mask' dialog. Possible values are yes and no.

(layer-merge-type expand-as-necessary)

Sets the default merge type for the 'Merge Visible Layers' dialog. Possible values are expand-as-necessary, clip-to-image, clip-to-bottom-layer and flatten-image.

(layer-merge-active-group-only yes)

Sets the default 'Active group only' for the 'Merge Visible Layers' dialog. Possible values are yes and no.

(layer-merge-discard-invisible no)

Sets the default 'Discard invisible' for the 'Merge Visible Layers' dialog. Possible values are yes and no.

(channel-new-name "Channel")

Sets the default channel name for the 'New Channel' dialog. This is a string value.

(channel-new-color

(color "R'G'B'A float" 16 " 77" 0)) Sets the default color and opacity for the 'New Channel' dialog. The color is specified as opaque GeglColor (any Alpha channel is ignored).

(path-new-name "Path")

Sets the default path name for the 'New Path' dialog. This is a string value.

Sets the default folder path for the 'Export Path' dialog. This is a single

filename.

(path-export-active-only yes)

Sets the default 'Export the selected paths' state for the 'Export Path' dialog. Possible values are yes and no.

Sets the default folder path for the 'Import Path' dialog. This is a single

filename.

(path-import-merge no)

Sets the default 'Merge imported paths' state for the 'Import Path' dialog. Possible values are yes and no.

(path-import-scale no)

Sets the default 'Scale imported paths to fit size' state for the 'Import Path' dialog. Possible values are yes and no.

(selection-feather-radius 5)

Sets the default feather radius for the 'Feather Selection' dialog. This is a float value.

(selection-feather-edge-lock yes)

Sets the default 'Selected areas continue outside the image' setting for the 'Feather Selection' dialog. Possible values are yes and no.

(selection-grow-radius 1)

Sets the default grow radius for the 'Grow Selection' dialog. This is a float value.

(selection-shrink-radius 1)

Sets the default shrink radius for the 'Shrink Selection' dialog. This is a float value.

(selection-shrink-edge-lock no)

Sets the default 'Selected areas continue outside the image' setting for the 'Shrink Selection' dialog. Possible values are yes and no.

(selection-border-radius 5)

Sets the default border radius for the 'Border Selection' dialog. This is a float value.

(selection-border-style smooth)

Sets the default border style for the 'Border Selection' dialog. Possible values are hard, smooth and feathered.

(selection-border-edge-lock no)

Sets the default 'Selected areas continue outside the image' setting for the 'Border Selection' dialog. Possible values are yes and no.

(fill-options

(style fg-color)

(custom-style solid-color)

(antialias yes)

(feather no)

(feather-radius 10)) The default fill options for the fill dialogs. This is a parameter list.

(stroke-options

(style fg-color)

(custom-style solid-color)

(antialias yes)

(feather no)

(feather-radius 10)

(method line)

(width 6)

(unit pixels)

(cap-style butt)

(join-style miter)

(miter-limit 10)

(dash-offset 0)

(dash-info 0)

(emulate-brush-dynamics no)) The default stroke options for the stroke dialogs. This is a parameter list.

(fractalexplorer-path "${gimp_dir}/fractalexplorer:${gimp_data_dir}/fractalexplorer")

Where to search for fractals used by the Fractal Explorer plug-in. This is a colon-separated list of folders to search.

(gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")

Where to search for Gfig figures used by the Gfig plug-in. This is a colon-separated list of folders to search.

(gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")

Where to search for gflares used by the GFlare plug-in. This is a colon-separated list of folders to search.

(gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gimpressionist")

Where to search for data used by the Gimpressionist plug-in. This is a colon-separated list of folders to search.

(script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")

This path will be searched for scripts when the Script-Fu plug-in is run. This is a colon-separated list of folders to search.

## PATH EXPANSION
Strings of type PATH are expanded in a manner similar to bash(1). Specifically: tilde (~) is expanded to the user's home directory. Note that the bash feature of being able to refer to other user's home directories by writing ~userid/ is not valid in this file.

${variable} is expanded to the current value of an environment variable. There are a few variables that are pre-defined:

gimp_dir

The personal gimp directory which is set to the value of the environment variable GIMP3_DIRECTORY or to $XDG_CONFIG_HOME/gimp/3.2.

gimp_data_dir

Base for paths to shareable data, which is set to the value of the environment variable GIMP3_DATADIR or to the compiled-in default value /usr/share/gimp/3.0.

gimp_plug_in_dir

Base to paths for architecture-specific plug-ins and modules, which is set to the value of the environment variable GIMP3_PLUGINDIR or to the compiled-in default value /usr/lib64/gimp/3.0.

gimp_sysconf_dir

Path to configuration files, which is set to the value of the environment variable GIMP3_SYSCONFDIR or to the compiled-in default value /etc/gimp/3.0.

gimp_cache_dir

Path to cached files, which is set to the value of the environment variable GIMP3_CACHEDIR or to the system default for per-user cached files.

gimp_temp_dir

Path to temporary files, which is set to the value of the environment variable GIMP3_TEMPDIR or to the system default for temporary files.

## FILES
/etc/gimp/3.0/gimprc

System-wide configuration file

$XDG_CONFIG_HOME/gimp/3.2/gimprc

Per-user configuration file

## SEE ALSO
gimp(1)