---
name: "fb_find_mode"
section: "9"
platform: "linux"
package: "linux-manual-3.16"
version: "3.16.56-1+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/fb_find_mode"
---

# fb\_find\_mode(9)

finds a valid video mode

## NAME

fb\_find\_mode - finds a valid video mode

## SYNOPSIS

**int fb\_find\_mode(struct fb\_var\_screeninfo \*** *var***, struct fb\_info \*** *info***, const char \*** *mode\_option***, const struct fb\_videomode \*** *db***, unsigned int** *dbsize***, const struct fb\_videomode \*** *default\_mode***, unsigned int** *default\_bpp***);**

## ARGUMENTS

*var*

frame buffer user defined part of display

*info*

frame buffer info structure

*mode\_option*

string video mode to find

*db*

video mode database

*dbsize*

size of *db*

*default\_mode*

default video mode to fall back to

*default\_bpp*

default color depth in bits per pixel

## DESCRIPTION

Finds a suitable video mode, starting with the specified mode in *mode\_option* with fallback to *default\_mode*. If *default\_mode* fails, all modes in the video mode database will be tried.

Valid mode specifiers for *mode\_option*:

\<xres\>x\<yres\>\[M\]\[R\]\[-\<bpp\>\]\[@\<refresh\>\]\[i\]\[m\] or \<name\>\[-\<bpp\>\]\[@\<refresh\>\]

with \<xres\>, \<yres\>, \<bpp\> and \<refresh\> decimal numbers and \<name\> a string.

If 'M' is present after yres (and before refresh/bpp if present), the function will compute the timings using VESA(tm) Coordinated Video Timings (CVT). If 'R' is present after 'M', will compute with reduced blanking (for flatpanels). If 'i' is present, compute interlaced mode. If 'm' is present, add margins equal to 1.8% of xres rounded down to 8 pixels, and 1.8% of yres. The char 'i' and 'm' must be after 'M' and 'R'. Example:

1024x768MR-8*60m* - Reduced blank with margins at 60Hz.

## NOTE

The passed struct *var* is \_not\_ cleared! This allows you to supply values for e.g. the grayscale and accel\_flags fields.

Returns zero for failure, 1 if using specified *mode\_option*, 2 if using specified *mode\_option* with an ignored refresh rate, 3 if default mode is used, 4 if fall back to any valid mode.

## COPYRIGHT