JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
man pages section 1M: System Administration Commands     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

Introduction

System Administration Commands - Part 1

6to4relay(1M)

acct(1M)

acctadm(1M)

acctcms(1M)

acctcon1(1M)

acctcon(1M)

acctcon2(1M)

acctdisk(1M)

acctdusg(1M)

acctmerg(1M)

accton(1M)

acctprc1(1M)

acctprc(1M)

acctprc2(1M)

acctsh(1M)

acctwtmp(1M)

acpihpd(1M)

adbgen(1M)

add_allocatable(1M)

addbadsec(1M)

add_drv(1M)

aimanifest(1M)

arp(1M)

asradm(1M)

asr-notify(1M)

atohexlabel(1M)

audit(1M)

auditconfig(1M)

auditd(1M)

auditrecord(1M)

auditreduce(1M)

auditstat(1M)

audit_warn(1M)

automount(1M)

automountd(1M)

autopush(1M)

bart(1M)

beadm(1M)

boot(1M)

bootadm(1M)

bootconfchk(1M)

bootparamd(1M)

busstat(1M)

captoinfo(1M)

catman(1M)

cfgadm(1M)

cfgadm_ac(1M)

cfgadm_cardbus(1M)

cfgadm_fp(1M)

cfgadm_ib(1M)

cfgadm_pci(1M)

cfgadm_sata(1M)

cfgadm_sbd(1M)

cfgadm_scsi(1M)

cfgadm_sdcard(1M)

cfgadm_shp(1M)

cfgadm_sysctrl(1M)

cfgadm_usb(1M)

chargefee(1M)

chat(1M)

check-hostname(1M)

check-permissions(1M)

chk_encodings(1M)

chroot(1M)

cimworkshop(1M)

ckpacct(1M)

clear_locks(1M)

clinfo(1M)

closewtmp(1M)

clri(1M)

comsat(1M)

configCCR(1M)

consadm(1m)

console-reset(1M)

coreadm(1M)

cpustat(1M)

croinfo(1M)

cron(1M)

cryptoadm(1M)

datadm(1M)

dcopy(1M)

dcs(1M)

dd(1M)

ddu(1M)

ddu-text(1M)

devchassisd(1M)

devfsadm(1M)

devfsadmd(1M)

device_allocate(1M)

device_remap(1M)

devinfo(1M)

devlinks(1M)

devnm(1M)

devprop(1M)

df(1M)

dfmounts(1M)

dfmounts_nfs(1M)

dfshares(1M)

dfshares_nfs(1M)

df_ufs(1M)

dhcpagent(1M)

dhcpconfig(1M)

dhcpmgr(1M)

dhtadm(1M)

dig(1M)

directoryserver(1M)

diskinfo(1M)

disks(1M)

diskscan(1M)

dispadmin(1M)

distro_const(1M)

dladm(1M)

dlmgmtd(1M)

dlstat(1M)

dmesg(1M)

dminfo(1M)

dns-sd(1M)

dnssec-dsfromkey(1M)

dnssec-keyfromlabel(1M)

dnssec-keygen(1M)

dnssec-makekeyset(1M)

dnssec-signkey(1M)

dnssec-signzone(1M)

dodisk(1M)

domainname(1M)

drd(1M)

drvconfig(1M)

dsbitmap(1M)

dscfg(1M)

dscfgadm(1M)

dscfglockd(1M)

dsstat(1M)

dsvclockd(1M)

dtrace(1M)

dumpadm(1M)

editmap(1M)

edquota(1M)

eeprom(1M)

efdaemon(1M)

embedded_su(1M)

emCCR(1M)

emocmrsp(1M)

etrn(1M)

fbconfig(1M)

fbconf_xorg(1M)

fcadm(1M)

fcinfo(1M)

fdetach(1M)

fdisk(1M)

ff(1M)

ff_ufs(1M)

fingerd(1M)

fiocompress(1M)

flowadm(1M)

flowstat(1M)

fmadm(1M)

fmd(1M)

fmdump(1M)

fmstat(1M)

fmthard(1M)

format(1M)

fruadm(1M)

fsck(1M)

fsck_pcfs(1M)

fsck_udfs(1M)

fsck_ufs(1M)

fsdb(1M)

fsdb_udfs(1M)

fsdb_ufs(1M)

fsflush(1M)

fsirand(1M)

fssnap(1M)

fssnap_ufs(1M)

fsstat(1M)

fstyp(1M)

fuser(1M)

fwflash(1M)

fwtmp(1M)

getdevpolicy(1M)

getent(1M)

gettable(1M)

getty(1M)

gkadmin(1M)

groupadd(1M)

groupdel(1M)

groupmod(1M)

growfs(1M)

grpck(1M)

gsscred(1M)

gssd(1M)

hald(1M)

hal-device(1M)

hal-fdi-validate(1M)

hal-find(1M)

hal-find-by-capability(1M)

hal-find-by-property(1M)

hal-get-property(1M)

hal-set-property(1M)

halt(1M)

hextoalabel(1M)

host(1M)

hostconfig(1M)

hotplug(1M)

hotplugd(1M)

htable(1M)

ickey(1M)

id(1M)

idmap(1M)

idmapd(1M)

idsconfig(1M)

ifconfig(1M)

if_mpadm(1M)

ifparse(1M)

iiadm(1M)

iicpbmp(1M)

iicpshd(1M)

ikeadm(1M)

ikecert(1M)

ilbadm(1M)

ilbd(1M)

ilomconfig(1M)

imqadmin(1M)

imqbrokerd(1M)

imqcmd(1M)

imqdbmgr(1M)

imqkeytool(1M)

imqobjmgr(1M)

imqusermgr(1M)

in.chargend(1M)

in.comsat(1M)

in.daytimed(1M)

in.dhcpd(1M)

in.discardd(1M)

in.echod(1M)

inetadm(1M)

inetconv(1M)

inetd(1M)

in.fingerd(1M)

infocmp(1M)

in.iked(1M)

init(1M)

init.sma(1M)

init.wbem(1M)

inityp2l(1M)

in.lpd(1M)

in.mpathd(1M)

in.named(1M)

in.ndpd(1M)

in.rarpd(1M)

in.rdisc(1M)

in.rexecd(1M)

in.ripngd(1M)

in.rlogind(1M)

in.routed(1M)

in.rshd(1M)

in.rwhod(1M)

install(1M)

installadm(1M)

installboot(1M)

installf(1M)

installgrub(1M)

in.stdiscover(1M)

in.stlisten(1M)

in.talkd(1M)

in.telnetd(1M)

in.tftpd(1M)

in.timed(1M)

intrd(1M)

intrstat(1M)

in.uucpd(1M)

iostat(1M)

ipaddrsel(1M)

ipadm(1M)

ipf(1M)

ipfs(1M)

ipfstat(1M)

ipmgmtd(1M)

ipmon(1M)

ipmpstat(1M)

ipnat(1M)

ippool(1M)

ipqosconf(1M)

ipsecalgs(1M)

ipsecconf(1M)

ipseckey(1M)

iscsiadm(1M)

isns(1M)

isnsadm(1M)

itadm(1M)

itu(1M)

js2ai(1M)

k5srvutil(1M)

kadb(1M)

kadmin(1M)

kadmind(1M)

kadmin.local(1M)

kcfd(1M)

kclient(1M)

kdb5_ldap_util(1M)

kdb5_util(1M)

kdcmgr(1M)

kernel(1M)

keyserv(1M)

killall(1M)

kmem_task(1M)

kmscfg(1M)

kprop(1M)

kpropd(1M)

kproplog(1M)

krb5kdc(1M)

ksslcfg(1M)

kstat(1M)

ktkt_warnd(1M)

labeld(1M)

labelit(1M)

labelit_hsfs(1M)

labelit_udfs(1M)

labelit_ufs(1M)

lastlogin(1M)

latencytop(1M)

ldapaddent(1M)

ldap_cachemgr(1M)

ldapclient(1M)

ldmad(1M)

link(1M)

llc2_loop(1M)

lldpadm(1M)

lldpd(1M)

lms(1M)

locator(1M)

lockd(1M)

lockfs(1M)

lockstat(1M)

lofiadm(1M)

logadm(1M)

logins(1M)

lshal(1M)

System Administration Commands - Part 2

System Administration Commands - Part 3

fbconf_xorg

- configure frame buffer devices for Xorg

Synopsis

/usr/lib/fbconfig/fbconf_xorg [-dev device-file]
     [-file machine | system | config-path]
     [-res video-mode [nocheck | noconfirm]]
     [device-specific-options]
     [-defaults] [-prconf] [-predid [raw] [parsed]] [-propt]
/usr/lib/fbconfig/fbconf_xorg [-dev device-file] [-prconf] [-propt]
/usr/lib/fbconfig/fbconf_xorg [-dev device-file] [-help] [-res ?]

Description

The fbconf_xorg utility configures Frame Buffer devices and some of the X11 window system defaults for Xorg by updating the xorg.conf configuration file. Users should not normally need to run fbconf_xorg directly, as it is executed by fbconfig(1M) when the Xorg server is in use.

The first fbconf_xorg command form shown in the SYNOPSIS section stores the specified option values in the xorg.conf configuration file. These settings are used to initialize the frame buffer device the next time the window system is run on that device. The persistence of these settings across window system sessions and system reboots is determined by the xorg.conf file.

The second and third command forms display information, and do not alter the xorg.conf file. The presence of the -help and/or -res ? options causes any other option (not shown in the third form) to be ignored.

You can configure only one frame buffer device at a time. To configure multiple devices, invoke the fbconf_xorg utility separately for each device.

Only frame buffer device options can be specified with fbconf_xorg. Use the normal window system options to specify default depth (see svccfg(1M)), default visual class, and so forth. Specify these as device modifiers on the command line as specified in Xserver(1).

You can specify which xorg.conf file to open. By default, fbconf_xorg opens the machine-specific file, /etc/X11/xorg.conf. Use the -file option to specify an alternate file. For example, the system-global file, /usr/lib/X11/xorg.conf, can be opened instead.

These standard xorg.conf files can be written only by the superuser or someone with the Desktop Configuration role.

Options

The following options are supported for all frame buffer devices:

-defaults

Sets configuration options for the specified device to their default values. This does not affect the -res video mode setting. See the device-specific portions of the DEFAULTS section below.

-dev device-file

Specifies the frame buffer device by either its full pathname or simple filename (for example, /dev/fbs/efb0 or efb0). Pathnames of installed devices can be displayed using the -list option to fbconfig(1M). If the -dev option is omitted, the default device, /dev/fb, is used.

-file machine | system | config-path

Specifies which xorg.conf file to open. If machine is specified, the machine-specific /etc/X11/xorg.conf file is opened. If system is specified, the global /usr/lib/X11/xorg.conf file is opened. The absolute pathname of a configuration file can be used instead. If the specified file does not exist and is to be updated, it is created. The file system that contains the xorg.conf file must be writeable by someone with superuser-like privileges. This option has no effect unless other options are specified. The default is machine.

-help

Display the fbconf_xorg command line options that are supported in conjunction with the frame buffer device, along with a brief explanation of each option. The frame buffer device can be specified using the -dev option.

-prconf

Display the current configuration for the frame buffer device and attached display device(s). The frame buffer device can be specified using the -dev option.

The -prconf output might resemble:

Monitor/Resolution Information:
    Monitor manufacturer: SUN
    Product Code:  4
    Serial Number: 12212555
    Manufacture date: 2000, week 9
    EDID Version:  1.1
    Monitor dimensions: 36x29 cm
    Default Gamma: 2.62
    Monitor preferred resolution: SUNW_STD_1280x1024x60
    Monitor supported resolutions from EDID: SUNW_STD_1280x1024x60,
        SUNW_STD_1280x1024x76, 1152x900x66, VESA_STD_1280x1024x75,
        VESA_STD_1280x1024x60, SUNW_STD_1152x900x66,
        VESA_STD_720x400x70, VESA_STD_640x480x60,
        VESA_STD_640x480x67, VESA_STD_640x480x72,
        VESA_STD_640x480x75, VESA_STD_800x600x56,
        VESA_STD_800x600x60, VESA_STD_800x600x72,
        VESA_STD_800x600x75, VESA_STD_832x624x75,
        VESA_STD_1024x768x60, VESA_STD_1024x768x70, 1024x768x75
    Current resolution setting: FALLBACK_1152x900x66

Framelock Configuration:
    Slave Mode: Disabled
-predid [raw] [parsed]

Display the E-EDID (Enhanced Extended Display Identification Data) information obtained from the display device(s), which must be online, connected to the frame buffer. The frame buffer device can be specified using the -dev option. The output is raw hexadecimal and/or human-readable (parsed) text. The default is parsed.

The -predid raw output might resemble:

--- EDID Data for /dev/fbs/kfb0 ---

Block 0: EDID Base Block
        0x00:  00 FF FF FF FF FF FF 00 04 43 06 F2 01 00 00 00
        0x10:  01 11 01 04 0F 2B 20 78 2B 9C 68 A0 57 4A 9B 26
        0x20:  12 48 4C FF FF 80 A9 59 A9 4F A9 4A A9 45 81 99
        0x30:  81 80 61 59 45 59 48 3F 40 30 62 B0 32 40 40 C0
        0x40:  13 00 AB 40 11 00 00 1E 00 00 00 FD 00 32 5A 1E
        0x50:  6E 17 04 11 00 C8 90 00 50 3C 00 00 00 F7 00 0A
        0x60:  F7 0F 03 87 C0 00 00 00 00 00 00 00 00 00 00 FC
        0x70:  00 41 42 43 20 4C 43 44 32 31 0A 20 20 20 00 0B
-propt

Display all option settings for the frame buffer device, either as they currently are or as they are represented in the xorg.conf configuration file when fbconf_xorg completes. The device can be specified using the -dev option, and the file using the -file option.

The -propt output might resemble:

--- Graphics Configuration for /dev/fbs/efb0 ---

xorg.conf: machine -- /etc/X11/xorg.conf
      Screen section:  "efb0"
      Device section:  "efb0"
      Monitor section: none

Video Mode: Not set

Screen Information:
      DoubleWide: Disable
      DoubleHigh: Disable
      Clone: Disable
      Offset/Overlap: [0, 0]
      Outputs:        Direct

Visual Information:
      Gamma Correction: Using default gamma value 2.22
-res ?

Display a list of video modes that can be used with the -res video-mode option.

The ? argument might need to be escaped or placed in quotes (\?, “?”, or '?'), to protect it from misinterpretation by the shell.

The -res ? output might resemble:

           Video modes accepted by the -res option:
                AUTO                      [1][2]
                NONE                      [1][2]
                SUNW_STD_1920x1200x75
                SUNW_STD_1920x1200x70
                SUNW_DIG_1920x1200x60
                SUNW_STD_1920x1080x72
                SUNW_DIG_1920x1080x60
                  ...
                  ...
                VESA_STD_640x480x75       [1]
                VESA_STD_640x480x72       [1]
                VESA_STD_640x480x60       [1]

           [1] Resolution is supported by monitor
           [2] Preferred resolution for monitor

Abbreviations such as “1280x1024x75” might also be used.

-res video-mode [nocheck | noconfirm]

Set the video mode for the display device that is connected to the frame buffer device.

A list of video modes can be displayed using the -res ? option.

The basic format of a video-mode is widthxheightxrate, where:

  • width is the screen width in pixels.

  • height is the screen height in pixels.

  • rate is the vertical frequency of the screen refresh.

A video-mode argument might have an @ (at sign) instead of x preceding the refresh rate. For instance, 1280x1024x76 and 1280x1024@76 are equivalent.

A video-mode name might carry additional information, as with SUNW_STD_1280x1024x76.

The -res argument, auto, represents the video mode that is currently programmed into the device. The argument, none, is a synonym for auto.

Note that some video modes might be inappropriate for certain frame buffer devices and/or display devices.

The -res option accepts suboption keywords following the video-mode specification.

nocheck

The nocheck suboption causes the video-mode argument to be accepted, regardless of whether it is supported by the currently attached monitor, whether it is known within the current configuration, and so forth. Note that using an unchecked, inappropriate video mode can leave the system without usable video output. This suboption is useful if a different monitor is to be connected to the frame buffer device. This suboption also implies noconfirm.

noconfirm

If the video-mode argument is unable to be validated, the default action is to display a warning message and ask the user whether to continue. The noconfirm suboption suppresses this confirmation request. This suboption is useful when fbconf_xorg is being run from a shell script.

The following device-specific options are supported for certain frame buffer devices. Unless specified otherwise, these options do not take effect until the user logs out and back in.

-deflinear true | false

This option selects the default X visual. Two types of visuals are supported, linear and nonlinear. Linear visuals are gamma corrected. Nonlinear visuals are not.

If the value of this option is true, the default visual is set to default depth 24 and the default class is TrueColor with gamma correction enabled. If false, a nonlinear visual that satisfies the other default visual selection options, such as the default depth and default class, is chosen as the default visual.

The -deflinear, -defoverlay, and -deftransparent options each select the default X visual. Only one of these might be enabled at a time. Enabling one causes the others to be disabled.

-defoverlay true | false

This option selects the default X visual. Some devices might provide an 8-bit PseudoColor visual whose pixels are disjoint from the rest of the visuals. This is called the overlay visual. Windows created in this visual does not damage windows created in other visuals. The converse, however, is not true: Windows created in other visuals damage overlay windows.

If the value of this option is true, the overlay visual is the default visual. The default depth is 8–bit and the default class is PseudoColor. If false, the non-overlay visual that satisfies the other default visual selection options, such as the default depth and the default class, is chosen as the default visual.

The -deflinear, -defoverlay, and -deftransparent options each select the default X visual. Only one of these might be enabled at a time. Enabling one causes the others to be disabled.

-deftransparent true | false

This option selects the default X visual. Some devices might provide an 8-bit PseudoColor visual whose pixels are disjoint from the rest of the visuals. This is called the overlay visual. Windows created in this visual does not damage windows created in other visuals.

If the value of this option is true, the overlay visual used as the default is a transparent overlay visual. A visual with transparency supports a colormap with 255 colors and one transparent pixel. The default depth is 8–bit and the default class is PseudoColor. If false, the nonoverlay visual that satisfies the other default visual selection options, such as the default depth and the default class, is chosen as the default visual.

The -deflinear, -defoverlay, and -deftransparent options each select the default X visual. Only one of these might be enabled at a time. Enabling one causes the others to be disabled.

-doublehigh enable | disable

Configures the two outputs of the frame buffer device into one vertical virtual display. The default is disable. The -doublewide and -doublehigh options are mutually exclusive. Enabling one causes the other to be disabled.

-doublewide enable | disable

Configures the two outputs of the frame buffer device into one horizontal virtual display. The default is disable. The -doublewide and -doublehigh options are mutually exclusive. Enabling one causes the other to be disabled.

-g gamma-correction-value

Sets the gamma correction value. All linear visuals provide gamma correction. The gamma correction value should be in the range, 0.1 to 10.0. The default is 2.22. This option can be used while the window system is running. Changing the gamma correction value affects all of the windows displayed by linear visuals.

-gfile gamma-correction-file

Loads the gamma correction table from the file specified by gamma-correction-file. This text file specifies the gamma correction values for the R, G, and B channels. Three consecutive values form an RGB triplet. For a kfb device, there must be exactly 256 RGB triplets. A value might be represented in hexadecimal, decimal, or octal format (for example, 0x3FF, 1023, or 01777, respectively). Values are separated by one or more whitespace or new line characters. Comments begin with a hash sign character (#) and end at the end of the line.

You can load the gamma correction table with this option while the window system is running. The new gamma correction affects all the windows being displayed using the linear visuals. When gamma correction is done using a user-specified table, the gamma correction value (-g) is undefined. By default, the window system assumes a gamma correction value of 2.22 and loads the gamma table it creates corresponding to this value.

The following is an example of a gamma-correction-file file:

             # Gamma Correction Table
             0x00 0x00 0x00
             0x01 0x01 0x01
             0x02 0x02 0x02
              ...  ...  ...
              ...  ...  ...
             0xFF 0xFF 0xFF
-multisample available | disable | forceon

If set to disable, no multisample is possible. If set to available, multisample is possible but is selected on a per-window basis using a library interface. If set to forceon, all Sun OpenGL windows are rendered using multisampling. To query the number of samples used, specify the -propt option.

-offset x-val y-val

Adjusts the position of the specified stream by the value specified. This option is only implemented in -doublewide and -doublehigh modes. For -doublewide, use the x-val to position the rightmost stream. Negative is left (overlaps with the left stream). For -doublehigh, use the y-val to position the bottom stream. Negative is up (overlaps with top stream). The default is [0,0].

-samples 1 | 2 | 4 | 8 | 16

Requests the number of samples to compute per display pixel. The requested number of samples per pixel is used if -multisample is not disabled and resources exist for the request. To query the number of samples used, specify the -propt option or run the xglinfo utility. The xglinfo utility can return the number of multisamples after you specify the option -multisample available. The default is 4.

-slave disable | multiview

If you set the multiview argument for the -slave option, the device synchronizes video with a master through the multiview genlock ribbon cable. The system should be powered off whenever connecting or disconnecting this cable. Both devices should be running the same resolution and the option should be issued when the window system is running. The default is disable.

Defaults

Certain options have implied default arguments. The default argument is used when the option is not present on the fbconf_xorg command line. For instance, a default argument for -dev is /dev/fb.

Options that set configuration state do not have implied defaults. The -res option is one example. If a configuration option is omitted from the fbconf_xorg command line, the corresponding xorg.conf configuration setting remains unchanged. The exception is that if configuration options are mutually exclusive, setting one automatically unsets each of the others. An example is -deflinear, -defoverlay, and -deftransparent.

If a configuration setting is not present in the configuration file when the window system is run, a default value is used. For instance, the default state associated with -res is auto. A setting might not be present in the file, or the file itself might not exist, until fbconf_xorg has been invoked with the corresponding command line option.

The -defaults option sets the default values for most configuration settings.

Options and their defaults are shown below.

Device-independent defaults:

             Option            Default Argument
             -dev              /dev/fb
             -file             machine

             Option            Default State
             -res              auto

Examples

Example 1 Switching the Resolution of the Monitor Type

The following example sets the video mode for the monitor on the /dev/fbs/efb0 device to 1280 x 1024 at 76 Hz:

example% fbconf_xorg -dev efb0 -res 1280x1024x76

Exit Status

The following exit values are returned:

0

Execution completed successfully.

1

Invalid command line usage.

2

An error occurred.

Files

/dev/fb

Symbolic link to the default frame buffer device.

/dev/fbs/efbnn

Device special file for an efb frame buffer

/usr/lib/fbconfig/SunModes_xorg.conf

Video mode definitions included in new configuration files.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/graphics/fbconfig/fbconfig-kfb
Interface Stability
Uncommitted

See Also

fbconfig(1M), svccfg(1M), attributes(5), efb(7D), fbio(7I)

See the Xorg(1) and Xserver(1) man pages in the X Server man page collection.