diff --git a/ChangeLog b/ChangeLog index 5107959..cc39fd5 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,6 @@ +2006-01-14 Karl Runge + * x11vnc: add -8to24 option for some multi-depth displays. + 2006-01-12 Karl Runge * configure.ac: add switches for most X extensions. diff --git a/x11vnc/8to24.c b/x11vnc/8to24.c new file mode 100644 index 0000000..5bea044 --- /dev/null +++ b/x11vnc/8to24.c @@ -0,0 +1,797 @@ +/* -- 8to24.c -- */ +#include "x11vnc.h" +#include "cleanup.h" +#include "scan.h" +#include "util.h" +#include "win_utils.h" + +int multivis_count = 0; + +void check_for_multivis(void); +void bpp8to24(int, int, int, int); +void mark_8bpp(void); + +static int check_depth(Window win, Window top, int doall); +static int check_depth_win(Window win, Window top, XWindowAttributes attr); + +/* struct for keeping info about the 8bpp windows: */ +typedef struct window8 { + Window win; + Window top; + int depth; + int x, y; + int w, h; + int map_state; + Colormap cmap; + Bool map_installed; + int fetched; +} window8bpp_t; + +/* fixed size array. Will primarily hold visable 8bpp windows */ +#define MAX_8BPP_WINDOWS 64 +static window8bpp_t windows_8bpp[MAX_8BPP_WINDOWS]; + +static int db24 = 0; + +void check_for_multivis(void) { + XWindowAttributes attr; + int doall = 0; + int k, i, cnt, diff; + static int first = 1; + static double last_update = 0.0; + static double last_clear = 0.0; + double now = dnow(); + static Window *stack_old = NULL; + static int stack_old_len = 0; + + if (first) { + int i; + /* initialize 8bpp window table: */ + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + windows_8bpp[i].win = None; + windows_8bpp[i].top = None; + windows_8bpp[i].map_state = IsUnmapped; + windows_8bpp[i].cmap = (Colormap) 0; + windows_8bpp[i].fetched = 0; + } + first = 0; + doall = 1; /* fetch everything first time */ + } + + /* + * allocate an "old stack" list of all toplevels. we compare + * this to the current stack to guess stacking order changes. + */ + if (!stack_old || stack_old_len < stack_list_len) { + int n = stack_list_len; + if (n < 256) { + n = 256; + } + if (stack_old) { + free(stack_old); + } + stack_old = (Window *) malloc(n*sizeof(Window)); + stack_old_len = n; + } + + /* fill the old stack with visable windows: */ + cnt = 0; + for (k=0; k < stack_list_num; k++) { + if (stack_list[k].valid && + stack_list[k].map_state == IsViewable) { + stack_old[cnt++] = stack_list[k].win; + } + } + + /* snapshot + update the current stacking order: */ + snapshot_stack_list(0, 0.25); + if (doall || now > last_update + 0.25) { + update_stack_list(); + last_update = now; + } + + /* look for differences in the visable toplevels: */ + diff = 0; + cnt = 0; + for (k=0; k < stack_list_num; k++) { + if (stack_list[k].valid && stack_list[k].map_state == IsViewable) { + if (stack_old[cnt] != stack_list[k].win) { + diff = 1; + break; + } + cnt++; + } + } + + /* + * if there are 8bpp visable and a stacking order change + * refresh vnc with coverage of the 8bpp regions: + */ + if (diff && multivis_count) { +if (db24 || 0) fprintf(stderr, "check_for_multivis stack diff: mark_all %f\n", now - x11vnc_start); + if (0) mark_rect_as_modified(0, 0, dpy_x, dpy_y, 0); + if (1) mark_8bpp(); + } + + multivis_count = 0; + + /* + * every 10 seconds we try to clean out and also refresh the window + * info in the the 8bpp window table: + */ + if (now > last_clear + 10) { + last_clear = now; + X_LOCK; + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + Window w = windows_8bpp[i].win; +if ((db24 || 0) && w != None) fprintf(stderr, " windows_8bpp: 0x%lx i=%02d ms: %d\n", windows_8bpp[i].win, i, windows_8bpp[i].map_state); + if (w == None || ! valid_window(w, &attr, 1)) { + /* catch windows that went away: */ + windows_8bpp[i].win = None; + windows_8bpp[i].top = None; + windows_8bpp[i].map_state = IsUnmapped; + windows_8bpp[i].cmap = (Colormap) 0; + windows_8bpp[i].fetched = 0; + } + } + X_UNLOCK; + } + + /* loop over all toplevels, both 8 and 24 depths: */ + for (k=0; k < stack_list_num; k++) { + Window r, parent; + Window *list0; + Status rc; + unsigned int nc0; + int i1; + + Window win = stack_list[k].win; + + if (win == None) { + continue; + } + + if (stack_list[k].map_state != IsViewable) { + int i; + /* + * if the toplevel became unmapped, mark it + * for the children as well... + */ + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + if (windows_8bpp[i].top == win) { + windows_8bpp[i].map_state = + stack_list[k].map_state; + } + } + } + + if (check_depth(win, win, doall)) { + /* + * returns 1 if no need to recurse down e.g. IT + * is 8bpp and we assume all lower one are too. + */ + continue; + } + + /* we recurse up to two levels down from stack_list windows */ + X_LOCK; + rc = XQueryTree(dpy, win, &r, &parent, &list0, &nc0); + X_UNLOCK; + if (! rc) { + continue; + } + + /* loop over grandchildren of rootwin: */ + for (i1=0; i1 < (int) nc0; i1++) { + Window win1 = list0[i1]; + Window *list1; + unsigned int nc1; + int i2; + + if (check_depth(win1, win, doall)) { + continue; + } + X_LOCK; + rc = XQueryTree(dpy, win1, &r, &parent, &list1, &nc1); + X_UNLOCK; + if (! rc) { + continue; + } + /* loop over great-grandchildren of rootwin: */ + for (i2=0; i2< (int) nc1; i2++) { + Window win2 = list1[i2]; + + if (check_depth(win2, win, doall)) { + continue; + } + /* more? Which wm does this? */ + } + if (nc1) { + X_LOCK; + XFree(list1); + X_UNLOCK; + } + } + if (nc0) { + X_LOCK; + XFree(list0); + X_UNLOCK; + } + } +} + +static int check_depth(Window win, Window top, int doall) { + XWindowAttributes attr; + + X_LOCK; + /* first see if it is (still) a valid window: */ + if (! valid_window(win, &attr, 1)) { + X_UNLOCK; + return 1; /* indicate done */ + } + X_UNLOCK; + if (! doall && attr.map_state != IsViewable) { + /* + * store results anyway... this may lead to table filling up, + * but currently this allows us to update state of onetime mapped + * windows. + */ + check_depth_win(win, top, attr); + return 1; /* indicate done */ + } else if (check_depth_win(win, top, attr)) { + return 1; /* indicate done */ + } else { + return 0; /* indicate not done */ + } +} + +static int check_depth_win(Window win, Window top, XWindowAttributes attr) { + + /* + * only store windows with depth not equal to the default visual's depth + * note some windows can have depth == 0 ... (skip them). + */ + if (attr.depth != depth && attr.depth > 0) { + + int i, j = -1, none = -1, nomap = -1; + int new = 0; + if (attr.map_state == IsViewable) { + /* count the visable ones: */ + multivis_count++; +if (db24 || 0) fprintf(stderr, "multivis: 0x%lx %d\n", win, attr.depth); + } + + /* try to find a table slot for this window: */ + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + if (none < 0 && windows_8bpp[i].win == None) { + /* found first None */ + none = i; + } + if (windows_8bpp[i].win == win) { + /* found myself */ + j = i; + break; + } + if (nomap < 0 && windows_8bpp[i].win != None && + windows_8bpp[i].map_state != IsViewable) { + /* found first unmapped */ + nomap = i; + } + } + if (j < 0) { + if (attr.map_state != IsViewable) { + /* no slot and not visable: not worth keeping */ + return 1; + } else if (none >= 0) { + /* put it in the first None slot */ + j = none; + new = 1; + } else if (nomap >=0) { + /* put it in the first unmapped slot */ + j = nomap; + } + /* otherwise we cannot store it... */ + } + +if (db24 || 0) fprintf(stderr, "multivis: 0x%lx ms: %d j: %d no: %d nm: %d\n", win, attr.map_state, j, none, nomap); + + /* store if if we found a slot j: */ + if (j >= 0) { + Window w; + int x, y; + +if (db24 || 0) fprintf(stderr, "multivis: STORE 0x%lx j: %3d ms: %d\n", win, j, attr.map_state); + windows_8bpp[j].win = win; + windows_8bpp[j].top = top; + windows_8bpp[j].depth = attr.depth; + windows_8bpp[j].map_state = attr.map_state; + windows_8bpp[j].cmap = attr.colormap; + windows_8bpp[j].map_installed = attr.map_installed; + windows_8bpp[j].w = attr.width; + windows_8bpp[j].h = attr.height; + + /* translate x y to be WRT the root window (not parent) */ + xtranslate(win, window, 0, 0, &x, &y, &w, 1); + windows_8bpp[j].x = x; + windows_8bpp[j].y = y; + + windows_8bpp[j].fetched = 1; + + if (new) { +if (db24) fprintf(stderr, "new: 0x%lx\n", win); + /* mark it immediately if a new one: */ + mark_rect_as_modified(x, y, x + attr.width, + y + attr.height, 0); + } + } else { + /* + * Error: could not find a slot. + * perhaps keep age and expire old ones?? + */ +if (db24 || 1) fprintf(stderr, "multivis: CANNOT STORE 0x%lx j=%d\n", win, j); + for (i=0; i < MAX_8BPP_WINDOWS; i++) { +if (db24 || 0) fprintf(stderr, " ------------ 0x%lx i=%d\n", windows_8bpp[i].win, i); + } + + } + return 1; + } + return 0; +} + +void bpp8to24(int x1, int y1, int x2, int y2) { + char *src; + char *dst; + int pixelsize = bpp/8; + int line, i, h, k, w; +# define CMAPMAX 64 + Colormap cmaps[CMAPMAX]; + int ncmaps, cmap_max = CMAPMAX; + sraRegionPtr rect, disp, region8bpp; + XWindowAttributes attr; + static int last_map_count = 0, call_count = 0; + static double last_validate = 0.0; + int validate = 1; + + if (! cmap8to24 || !cmap8to24_fb) { + /* hmmm, why were we called? */ + return; + } + + call_count++; + + /* initialize color map list */ + ncmaps = 0; + for (i=0; i < cmap_max; i++) { + cmaps[i] = (Colormap) 0; + } + + /* create regions for finding overlap, etc. */ + disp = sraRgnCreateRect(0, 0, dpy_x, dpy_y); + rect = sraRgnCreateRect(x1, y1, x2, y2); + region8bpp = sraRgnCreate(); + + X_LOCK; + XFlush(dpy); /* make sure X server is up to date WRT input, etc */ + X_UNLOCK; + + if (last_map_count > MAX_8BPP_WINDOWS/4) { + /* table is filling up... skip validating sometimes: */ + int skip = 3; + if (last_map_count > MAX_8BPP_WINDOWS/2) { + skip = 6; + } + if (last_map_count > 3*MAX_8BPP_WINDOWS/4) { + skip = 12; + } + if (call_count % skip != 0) { + validate = 0; +fprintf(stderr, " bpp8to24: No validate: %d -- %d\n", skip, last_map_count); + } else { +fprintf(stderr, " bpp8to24: yesvalidate: %d -- %d\n", skip, last_map_count); + } + } + last_map_count = 0; + + /* loop over the table of 8bpp windows: */ + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + sraRegionPtr tmp_reg, tmp_reg2; + Window w = windows_8bpp[i].win; + Window c; + int x, y; + + if (wireframe_in_progress) { + break; /* skip updates during wireframe drag */ + } + + if (w == None) { + continue; + } + +if (db24 || 0) fprintf(stderr, "bpp8to24: 0x%lx ms=%d i=%d\n", w, windows_8bpp[i].map_state, i); + if (validate) { + /* + * this could be slow: validating 8bpp windows each + * time... + */ + last_validate = dnow(); + + X_LOCK; + if (! valid_window(w, &attr, 1)) { + X_UNLOCK; + windows_8bpp[i].win = None; + windows_8bpp[i].top = None; + windows_8bpp[i].map_state = IsUnmapped; + windows_8bpp[i].cmap = (Colormap) 0; + windows_8bpp[i].fetched = 0; + continue; + } + X_UNLOCK; + if (attr.map_state != IsViewable) { + continue; + } + + X_LOCK; + xtranslate(w, window, 0, 0, &x, &y, &c, 1); + X_UNLOCK; + } else { + /* this would be faster: no call to X server: */ + if (windows_8bpp[i].map_state != IsViewable) { + continue; + } + x = windows_8bpp[i].x; + y = windows_8bpp[i].y; + attr.width = windows_8bpp[i].w; + attr.height = windows_8bpp[i].h; + attr.map_state = windows_8bpp[i].map_state; + attr.colormap = windows_8bpp[i].cmap; + + } + last_map_count++; + + /* tmp region for this 8bpp rectangle: */ + tmp_reg = sraRgnCreateRect(x, y, x + attr.width, + y + attr.height); + + /* clip to display screen: */ + sraRgnAnd(tmp_reg, disp); + + /* find overlap with mark region in rect: */ + sraRgnAnd(tmp_reg, rect); + if (sraRgnEmpty(tmp_reg)) { + /* skip if no overlap: */ + sraRgnDestroy(tmp_reg); + continue; + } + + /* loop over all toplevels, top to bottom clipping: */ + for (k = stack_list_num - 1; k >= 0; k--) { + Window swin = stack_list[k].win; + int sx, sy, sw, sh; + +if (db24) fprintf(stderr, "Stack win: 0x%lx %d iv=%d\n", swin, k, stack_list[k].map_state); + + if (swin == windows_8bpp[i].top) { + /* found our top level: we clip the rest. */ +if (db24) fprintf(stderr, "found top: 0x%lx %d iv=%d\n", swin, k, stack_list[k].map_state); + break; + } + if (stack_list[k].map_state != IsViewable) { + /* skip unmapped ones: */ + continue; + } + + /* make a temp rect for this toplevel: */ + sx = stack_list[k].x; + sy = stack_list[k].y; + sw = stack_list[k].width; + sh = stack_list[k].height; + + tmp_reg2 = sraRgnCreateRect(sx, sy, sx + sw, sy + sh); + sraRgnAnd(tmp_reg2, disp); + + /* subtrace it from the 8bpp window region */ + sraRgnSubtract(tmp_reg, tmp_reg2); + sraRgnDestroy(tmp_reg2); + } + + if (sraRgnEmpty(tmp_reg)) { + /* skip this 8bpp if completely clipped away: */ + sraRgnDestroy(tmp_reg); +if (db24) fprintf(stderr, "Empty tmp_reg\n"); + continue; + } + + /* otherwise, store any new colormaps: */ + if (ncmaps < cmap_max && attr.colormap != (Colormap) 0) { + int m, sawit = 0; + for (m=0; m < ncmaps; m++) { + if (cmaps[m] == attr.colormap) { + sawit = 1; + break; + } + } + if (! sawit) { + /* store only new ones: */ + cmaps[ncmaps++] = attr.colormap; + } + } + + /* now include this region with the full 8bpp region: */ + sraRgnOr(region8bpp, tmp_reg); + sraRgnDestroy(tmp_reg); + } + + /* copy from main_fb to cmap8to24_fb regardless of 8bpp windows: */ + src = main_fb + main_bytes_per_line * y1 + pixelsize * x1; + dst = cmap8to24_fb + main_bytes_per_line * y1 + pixelsize * x1; + h = y2 - y1; + w = x2 - x1; + + for (line = 0; line < h; line++) { + memcpy(dst, src, w * pixelsize); + src += main_bytes_per_line; + dst += main_bytes_per_line; + } + +if (db24) fprintf(stderr, "bpp8to24 w=%d h=%d m=%p c=%p r=%p \n", w, h, main_fb, cmap8to24_fb, rfb_fb); + + /* + * now go back and tranform and 8bpp regions to TrueColor in + * cmap8to24_fb. we have to guess the best colormap to use if + * there is more than one... + */ +#define NCOLOR 256 + if (! sraRgnEmpty(region8bpp) && ncmaps) { + sraRectangleIterator *iter; + sraRect rect; + int i, j, ncells; + int cmap_failed[CMAPMAX]; + static XColor color[CMAPMAX][NCOLOR]; + static unsigned int rgb[CMAPMAX][NCOLOR]; + XErrorHandler old_handler; + +#if 0 + /* not working properly for depth 24... */ + X_LOCK; + ncells = CellsOfScreen(ScreenOfDisplay(dpy, scr)); + X_UNLOCK; +#else + ncells = NCOLOR; +#endif + /* ncells should "always" be 256. */ + if (ncells > NCOLOR) { + ncells = NCOLOR; + } else if (ncells == 8) { + /* hmmm. see set_colormap() */ + ncells = NCOLOR; + } + + /* + * first, grab all of the associated colormaps from the + * X server. Hopefully just 1 or 2... + */ + for (j=0; j> 8; + green = (color[j][i].green & 0xff00) >> 8; + blue = (color[j][i].blue & 0xff00) >> 8; + + /* + * the maxes should be at 255 already, + * but just in case... + */ + red = (main_red_max * red )/255; + green = (main_green_max * green)/255; + blue = (main_blue_max * blue )/255; + + /* shift them over and or together for value */ + red = red << main_red_shift; + green = green << main_green_shift; + blue = blue << main_blue_shift; + + rgb[j][i] = red | green | blue; + } + } + + /* loop over the rectangles making up region8bpp */ + iter = sraRgnGetIterator(region8bpp); + while (sraRgnIteratorNext(iter, &rect)) { + double score, max_score = -1.0; + int n, m, best; + + if (rect.x1 > rect.x2) { + int tmp = rect.x2; + rect.x2 = rect.x1; + rect.x1 = tmp; + } + if (rect.y1 > rect.y2) { + int tmp = rect.y2; + rect.y2 = rect.y1; + rect.y1 = tmp; + } + +if (db24 || 0) fprintf(stderr, "ncmaps: %d\n", ncmaps); + + /* + * try to pick the "best" colormap to use for + * this rectangle (often wrong... let them + * iconify or move the trouble windows, etc.) + */ + best = -1; + + for (m=0; m < MAX_8BPP_WINDOWS; m++) { + int mx1, my1, mx2, my2; + int k, failed = 0; + if (windows_8bpp[m].win == None) { + continue; + } + if (windows_8bpp[m].map_state != IsViewable) { + continue; + } + + /* see if XQueryColors failed: */ + for (k=0; k max_score) { + max_score = score; + best = m; + } + +if (db24 || 0) fprintf(stderr, "cmap_score: 0x%x %.3f %.3f\n", (int) windows_8bpp[m].cmap, score, max_score); + + } + + if (best < 0) { + /* hmmm, use the first one then... */ + best = 0; + } else { + int ok = 0; + /* + * find the cmap corresponding to best window + * note we reset best from the windows_8bpp + * index to the cmaps[]. + */ + for (m=0; m < ncmaps; m++) { + if (cmaps[m] == windows_8bpp[best].cmap) { + ok = 1; + best = m; + } + } + if (! ok) { + best = 0; + } + } + + +if (db24) fprintf(stderr, "transform %d %d %d %d\n", rect.x1, rect.y1, rect.x2, rect.y2); + + /* now tranform the pixels in this rectangle: */ + n = main_bytes_per_line * rect.y1 + pixelsize * rect.x1; + + src = cmap8to24_fb + n; + h = rect.y2 - rect.y1; + w = rect.x2 - rect.x1; + + for (line = 0; line < h; line++) { + /* line by line ... */ + for (j = 0; j < w; j++) { + /* pixel by pixel... */ + unsigned int *ui; + unsigned int hi, idx; + + /* grab 32 bit value */ + ui = (unsigned int *) (src + pixelsize * j); + + /* extract top 8 bits (FIXME: masks?) */ + hi = (*ui) & 0xff000000; + + /* map to lookup index; rewrite pixel: */ + idx = hi >> 24; + *ui = hi | rgb[best][idx]; + } + src += main_bytes_per_line; + } + } + sraRgnReleaseIterator(iter); + } + + /* cleanup */ + sraRgnDestroy(disp); + sraRgnDestroy(rect); + sraRgnDestroy(region8bpp); +} + +void mark_8bpp(void) { + int i, cnt = 0; + + if (! cmap8to24 || !cmap8to24_fb) { + return; + } + + /* for each mapped 8bpp window, mark it changed: */ + + for (i=0; i < MAX_8BPP_WINDOWS; i++) { + int x1, y1, x2, y2, w, h, f = 32; + f = 0; /* skip fuzz, may bring in other windows... */ + + if (windows_8bpp[i].win == None) { + continue; + } + if (windows_8bpp[i].map_state != IsViewable) { + continue; + } + + x1 = windows_8bpp[i].x; + y1 = windows_8bpp[i].y; + w = windows_8bpp[i].w; + h = windows_8bpp[i].h; + + /* apply a fuzz f around each one... constrain to screen */ + x2 = x1 + w; + y2 = y1 + h; + x1 = nfix(x1 - f, dpy_x); + y1 = nfix(y1 - f, dpy_y); + x2 = nfix(x2 + f, dpy_x); + y2 = nfix(y2 + f, dpy_y); + +if (db24 || 0) fprintf(stderr, "mark_8bpp: 0x%lx %d %d %d %d\n", windows_8bpp[i].win, x1, y1, x2, y2); + + mark_rect_as_modified(x1, y1, x2, y2, 0); + cnt++; + } + if (cnt) { + /* push it to viewers if possible. */ + rfbPE(-1); + } +} + diff --git a/x11vnc/8to24.h b/x11vnc/8to24.h new file mode 100644 index 0000000..9861908 --- /dev/null +++ b/x11vnc/8to24.h @@ -0,0 +1,12 @@ +#ifndef _X11VNC_8TO24_H +#define _X11VNC_8TO24_H + +/* -- 8to24.h -- */ + +extern int multivis_count; + +extern void check_for_multivis(void); +extern void bpp8to24(int, int, int, int); +extern void mark_8bpp(void); + +#endif /* _X11VNC_8TO24_H */ diff --git a/x11vnc/ChangeLog b/x11vnc/ChangeLog index dcab5b4..6b72675 100644 --- a/x11vnc/ChangeLog +++ b/x11vnc/ChangeLog @@ -1,3 +1,7 @@ +2006-01-14 Karl Runge + * x11vnc: add -8to24 option for some multi-depth displays (but use + of -overlay is preferred is supported). + 2006-01-12 Karl Runge * fix -DSMALL_FOOTPRINT=N builds. diff --git a/x11vnc/Makefile.am b/x11vnc/Makefile.am index 6c8c977..35b3ba9 100644 --- a/x11vnc/Makefile.am +++ b/x11vnc/Makefile.am @@ -13,7 +13,7 @@ endif if HAVE_X bin_PROGRAMS=x11vnc -x11vnc_SOURCES = cleanup.c connections.c cursor.c gui.c help.c inet.c keyboard.c options.c pointer.c rates.c remote.c scan.c screen.c selection.c solid.c user.c userinput.c util.c win_utils.c x11vnc.c x11vnc_defs.c xdamage.c xevents.c xinerama.c xkb_bell.c xrandr.c xrecord.c xwrappers.c allowed_input_t.h blackout_t.h cleanup.h connections.h cursor.h enums.h gui.h help.h inet.h keyboard.h options.h params.h pointer.h rates.h remote.h scan.h screen.h scrollevent_t.h selection.h solid.h tkx11vnc.h user.h userinput.h util.h win_utils.h winattr_t.h x11vnc.h xdamage.h xevents.h xinerama.h xkb_bell.h xrandr.h xrecord.h xwrappers.h +x11vnc_SOURCES = 8to24.c cleanup.c connections.c cursor.c gui.c help.c inet.c keyboard.c options.c pointer.c rates.c remote.c scan.c screen.c selection.c solid.c user.c userinput.c util.c win_utils.c x11vnc.c x11vnc_defs.c xdamage.c xevents.c xinerama.c xkb_bell.c xrandr.c xrecord.c xwrappers.c 8to24.h allowed_input_t.h blackout_t.h cleanup.h connections.h cursor.h enums.h gui.h help.h inet.h keyboard.h options.h params.h pointer.h rates.h remote.h scan.h screen.h scrollevent_t.h selection.h solid.h tkx11vnc.h user.h userinput.h util.h win_utils.h winattr_t.h x11vnc.h xdamage.h xevents.h xinerama.h xkb_bell.h xrandr.h xrecord.h xwrappers.h INCLUDES=@X_CFLAGS@ x11vnc_LDADD=@X_LIBS@ $(LD_CYGIPC) $(LDADD) endif diff --git a/x11vnc/README b/x11vnc/README index 7e7bc33..93745a6 100644 --- a/x11vnc/README +++ b/x11vnc/README @@ -1,5 +1,5 @@ -x11vnc README file Date: Wed Jan 11 23:08:25 EST 2006 +x11vnc README file Date: Sat Jan 14 22:04:39 EST 2006 The following information is taken from these URLs: @@ -1604,7 +1604,8 @@ display :0 On some hardware (Sun/SPARC, Sgi), the [201]-overlay option discussed a couple paragraphs down may solve this for you (you may want to skip - to it directly). + to it directly). On other hardware the less robust [202]-8to24 option + may help. Run xdpyinfo(1) to see what the default visual is and what the depths of the other visuals are. Does the default visual have a depth of 8? @@ -1640,7 +1641,7 @@ TrueColor defdepth 24 The -overlay mode: Another option is if the system with overlay visuals is a Sun system running Solaris or Sgi running IRIX you can - use the [202]-overlay x11vnc option (Aug/2004) to have x11vnc use the + use the [203]-overlay x11vnc option (Aug/2004) to have x11vnc use the Solaris XReadScreen(3X11) function to poll the "true view" of the whole screen at depth 24 TrueColor. XReadDisplay(3X11) is used on IRIX. This is useful for Legacy applications (older versions of @@ -1650,28 +1651,51 @@ TrueColor defdepth 24 described in the previous paragraph is not sufficient for these apps. Misc. notes on -overlay mode: An amusing by-product of -overlay mode - is that mouse cursor shape is correct. The -overlay mode may be - somewhat slower than normal mode due to the extra framebuffer - manipulations that must be performed. Also, on Solaris there is a bug - in that for some popup menus, the windows they overlap will have - painting errors (flashing colors) while the popup is up (a workaround - is to disable SaveUnders by passing -su to Xsun, e.g. in your - /etc/dt/config/Xservers file). + is that the mouse cursor shape is correct! (i.e. XFIXES is not + needed). The -overlay mode may be somewhat slower than normal mode due + to the extra framebuffer manipulations that must be performed. Also, + on Solaris there is a bug in that for some popup menus, the windows + they overlap will have painting errors (flashing colors) while the + popup is up (a workaround is to disable SaveUnders by passing -su to + Xsun, e.g. in your /etc/dt/config/Xservers file). + + + The -8to24 mode: The [204]-8to24 x11vnc option (Jan/2006) is a kludge + to try to dynamically rewrite the pixel values so that the 8bpp part + is mapped onto depth 24 TrueColor and overwrites bits 1-24 of the + pixel. This is less robust than the -overlay mode because it is done + by x11vnc outside of the X server. So only use it on OS's that do not + support -overlay. The -8to24 mode will only work if the default visual + is depth 24. Then it scans for any windows within 3 levels of the root + window that are 8bpp (i.e. legacy application). For the ones it finds + it tries to use the correct indexed colormap to rewrite bits 1-24 of + the pixels. + + This scheme is approximate and can often lead to painting errors. You + can manually correct most painting errors by pressing 3 Alt_L's in a + row, or by using something like: [205]-fixscreen V=3.0 to + automatically refresh the screen every 3 seconds. In general the + scheme uses many resources and may give rise to sluggish behavior. If + multiple windows are using different 8bpp indexed colormaps all but + one window may need to be iconified for the colors to be correct. Note + that there is no analogous -24to8 mode for use on multi-depth displays + with default visuals of 8bpp. Colors still not working correctly? Run xwininfo on the application with the incorrect colors to verify that the depth of its visual is different from the default visual depth (gotten from xdpyinfo). One - possible workaround in this case is to use the [203]-id option to + possible workaround in this case is to use the [206]-id option to point x11vnc at the application window itself. If the application is complicated (lots of toplevel windows and popup menus) this may not be acceptable, and may even crash x11vnc (but not the application). It is theoretically possible to solve this problem in general (see xwd(1) for example), but it does not seem trivial or sufficiently fast - for x11vnc to be able to do so in real time. Fortunately the - [204]-overlay option works for Solaris machines with overlay visuals - where most of this problem occurs. + for x11vnc to be able to do so in real time. The [207]-8to24 method + does this approximately. Fortunately the [208]-overlay option works + for Solaris machines with overlay visuals where most of this problem + occurs. Q-17: How do I figure out the window id to supply to the -id windowid @@ -1681,9 +1705,9 @@ TrueColor defdepth 24 the desired application window. After clicking, it will print out much information, including the window id (e.g. 0x6000010). Also, the visual and depth of the window printed out is often useful in - debugging x11vnc [205]color problems. + debugging x11vnc [209]color problems. - Also, as of Dec/2004 libvncserver CVS you can use "[206]-id pick" to + Also, as of Dec/2004 libvncserver CVS you can use "[210]-id pick" to have x11vnc run xwininfo(1) for you and after you click the window it extracts the windowid. Besides "pick" there is also "id:root" to allow you to go back to root window when doing remote-control. @@ -1701,7 +1725,7 @@ TrueColor defdepth 24 you should be able to see these transient windows. If things are not working and you still want to do the single window - polling, try the [207]-sid windowid option ("shifted" windowid). + polling, try the [211]-sid windowid option ("shifted" windowid). Q-19: My X display is depth 24 at 24bpp (instead of the normal depth @@ -1751,15 +1775,15 @@ TrueColor defdepth 24 since you will be polling the X display over the network as opposed to over the local hardware. To do this, run x11vnc on a UNIX machine as close as possible network-wise (e.g. same switch) to the Xterminal - machine. Use the [208]-display option to point the display to that of + machine. Use the [212]-display option to point the display to that of the Xterminal (you'll of course need basic X11 permission to do that) - and also supply the [209]-noshm option (this enables the polling over + and also supply the [213]-noshm option (this enables the polling over the network). The response will likely be sluggish (maybe only one "frame" per second). This mode is not recommended except for "quick checks" of hard to get to X servers. Use something like "-wait 150" to cut down - on the polling rate. You may also need [210]-flipbyteorder if the + on the polling rate. You may also need [214]-flipbyteorder if the colors get messed up due to endian byte order differences. Q-21: How do I get my X permissions (MIT-MAGIC-COOKIE file) correct @@ -1783,7 +1807,7 @@ TrueColor defdepth 24 copied to the Xterminal. If $HOME/.Xauthority is exported via NFS (this is insecure of course, but has been going on for decades), then x11vnc can simply pick it up via NFS (you may need to use the - [211]-auth option to point to the correct file). Other options include + [215]-auth option to point to the correct file). Other options include copying the auth file using scp, or something like: central-server> xauth nextract - xterm123:0 | ssh xterm123 xauth nmerge - @@ -1795,7 +1819,7 @@ TrueColor defdepth 24 details. If the display name in the cookie file needs to be changed between the - two hosts, see [212]this note on the "xauth add ..." command. + two hosts, see [216]this note on the "xauth add ..." command. A less secure option is to run something like "xhost +127.0.0.1" while sitting at the Xterminal box to allow cookie-free local access for @@ -1809,7 +1833,7 @@ TrueColor defdepth 24 occasional app more efficiently locally on the Xterminal box (e.g. realplayer). - Not recommended, but as a last resort, you could have x11vnc [213]poll + Not recommended, but as a last resort, you could have x11vnc [217]poll the Xterminal Display over the network. For this you would run a "x11vnc -noshm ..." process on the central-server (and hope the network admin doesn't get angry...) @@ -1840,17 +1864,17 @@ TrueColor defdepth 24 As of Dec/2004 in the libvncserver CVS there is a remote control feature. It can change a huge amount of things on the fly: see the - [214]-remote and [215]-query options. To shut down the running x11vnc + [218]-remote and [219]-query options. To shut down the running x11vnc server just type "x11vnc -R stop". To disconnect all clients do "x11vnc -R disconnect:all", etc. - If the [216]-forever option has not been supplied, x11vnc will + If the [220]-forever option has not been supplied, x11vnc will automatically exit after the first client disconnects. In general you will have to kill the x11vnc process This can be done via: "kill NNNNN" (where NNNNN is the x11vnc process id number found from ps(1)), or "pkill x11vnc", or "killall x11vnc" (Linux only). - If you have not put x11vnc in the background via the [217]-bg option + If you have not put x11vnc in the background via the [221]-bg option or shell & operator, then simply press Ctrl-C in the shell where x11vnc is running to stop it. @@ -1860,15 +1884,15 @@ TrueColor defdepth 24 down state in the Xserver. Tapping the stuck key (either via a new x11vnc or at the physical console) will release it from the stuck state. If the keyboard seems to be acting strangely it is often fixed - by tapping Ctrl, Shift, and Alt. Alternatively, the [218]-clear_mods - option and [219]-clear_keys option can be used to release pressed keys + by tapping Ctrl, Shift, and Alt. Alternatively, the [222]-clear_mods + option and [223]-clear_keys option can be used to release pressed keys at startup and exit. Q-23: Can I change settings in x11vnc without having to restart it? Can I remote control it? - Look at the [220]-remote (same as -R) and [221]-query (same as -Q) + Look at the [224]-remote (same as -R) and [225]-query (same as -Q) options added in the Dec/2004 libvncserver CVS. They allow nearly everything to be changed dynamically and settings to be queried. Examples: "x11vnc -R shared", "x11vnc -R forever", "x11vnc -R @@ -1880,7 +1904,7 @@ TrueColor defdepth 24 be possible. There is also a simple Tcl/Tk gui based on this remote control - mechanism. See the [222]-gui option for more info. You will need to + mechanism. See the [226]-gui option for more info. You will need to have Tcl/Tk (i.e. /usr/bin/wish) installed for it to work. It can also run in the system tray: "-gui tray" or as a standalone icon window: "-gui icon". @@ -1895,12 +1919,12 @@ TrueColor defdepth 24 vncpasswd(1) program from those packages. The libvncserver package also comes with a simple program: storepasswd in the examples directory. And as of Jun/2004 in the libvncserver CVS x11vnc supports - the -storepasswd "pass" "file" [223]option, which is the the same + the -storepasswd "pass" "file" [227]option, which is the the same functionality of storepasswd. Be sure to quote the "pass" if it contains shell meta characters, spaces, etc. Example: x11vnc -storepasswd 'sword*fish' $HOME/myvncpasswd - You then use the password via the x11vnc option: [224]-rfbauth + You then use the password via the x11vnc option: [228]-rfbauth $HOME/myvncpasswd Compared to vncpasswd(1) the latter two methods are a somewhat unsafe @@ -1909,7 +1933,7 @@ TrueColor defdepth 24 out for the command winding up in your shell's history file (history -c is often a way to clear it). - x11vnc also has the [225]-passwdfile and -passwd/-viewpasswd plain + x11vnc also has the [229]-passwdfile and -passwd/-viewpasswd plain text (i.e. not obscured like the -rfbauth VNC passwords) password options. @@ -1920,7 +1944,7 @@ TrueColor defdepth 24 You can use the vncpasswd program from RealVNC or TightVNC mentioned above.. - Alternatively, this script should keep your [226]-storepasswd more + Alternatively, this script should keep your [230]-storepasswd more private: #!/bin/sh # usage: x11vnc_pw [file] (default: ~/.vnc/passwd) @@ -1955,13 +1979,13 @@ ls -l "$file" and the other for view-only access to the display? Yes, as of May/2004 in the libvncserver CVS there is the - [227]-viewpasswd option to supply the view-only password. Note the - full-access password option [228]-passwd must be supplied at the same + [231]-viewpasswd option to supply the view-only password. Note the + full-access password option [232]-passwd must be supplied at the same time. E.g.: -passwd sword -viewpasswd fish. To avoid specifying the passwords on the command line (where they could be observed via the ps(1) command by any user) you can use the - [229]-passwdfile option to specify a file containing plain text + [233]-passwdfile option to specify a file containing plain text passwords. Presumably this file is readable only by you, and ideally it is located on the machine x11vnc is run on (to avoid being snooped on over the network). The first line of this file is the full-access @@ -1969,7 +1993,7 @@ ls -l "$file" it is taken as the view-only password. (use "__EMPTY__" to supply an empty one). - View-only passwords currently do not work for the [230]-rfbauth + View-only passwords currently do not work for the [234]-rfbauth password option (standard VNC password storing mechanism). FWIW, note that although the output (usually placed in $HOME/.vnc/passwd) by the vncpasswd or storepasswd programs (or from x11vnc -storepasswd) looks @@ -1983,7 +2007,7 @@ ls -l "$file" some users just be able to move the mouse, but not click or type anything? - As of Feb/2005, the [231]-input option allows you to do this. "K", + As of Feb/2005, the [235]-input option allows you to do this. "K", "M", and "B" stand for Keystroke, Mouse-motion, and Button-clicks, respectively. The setting: "-input M" makes attached viewers only able to move the mouse. "-input KMB,M" lets normal clients do everything @@ -1999,15 +2023,15 @@ ls -l "$file" These defaults are simple safety measures to avoid someone unknowingly leaving his X11 desktop exposed (to the internet, say) for long - periods of time. Use the [232]-forever option (aka -many) to have + periods of time. Use the [236]-forever option (aka -many) to have x11vnc wait for more connections after the first client disconnects. - Use the [233]-shared option to have x11vnc allow multiple clients to + Use the [237]-shared option to have x11vnc allow multiple clients to connect simultaneously. - Recommended additional safety measures include using ssh ([234]see + Recommended additional safety measures include using ssh ([238]see above), stunnel, or a VPN to authenticate and encrypt the viewer - connections or to at least use the -rfbauth passwd-file [235]option to - use VNC password protection (or [236]-passwdfile) It is up to YOU to + connections or to at least use the -rfbauth passwd-file [239]option to + use VNC password protection (or [240]-passwdfile) It is up to YOU to apply these security measures, they will not be done for you automatically. @@ -2015,7 +2039,7 @@ ls -l "$file" Q-29: Can I limit which machines incoming VNC clients can connect from? - Yes, look at the [237]-allow and [238]-localhost options to limit + Yes, look at the [241]-allow and [242]-localhost options to limit connections by hostname or IP address. E.g. x11vnc -allow 192.168.0.1,192.168.0.2 @@ -2027,7 +2051,7 @@ ls -l "$file" Note that -localhost is the same as "-allow 127.0.0.1" For more control, build libvncserver with libwrap support - [239](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) + [243](tcp_wrappers) and then use /etc/hosts.allow See hosts_access(5) for complete details. @@ -2047,7 +2071,7 @@ ls -l "$file" is "vnc", e.g.: vnc: 192.168.100.3 .example.com - Note that if you run x11vnc out of [240]inetd you do not need to build + Note that if you run x11vnc out of [244]inetd you do not need to build x11vnc with libwrap support because the /usr/sbin/tcpd reference in /etc/inetd.conf handles the tcp_wrappers stuff. @@ -2056,16 +2080,16 @@ ls -l "$file" internal LAN) rather than having it listen on all network interfaces and relying on -allow to filter unwanted connections out? - As of Mar/2005 in the libvncserver CVS, there is the "[241]-listen + As of Mar/2005 in the libvncserver CVS, there is the "[245]-listen ipaddr" option that enables this. For ipaddr either supply the desired network interface's IP address (or use a hostname that resolves to it) or use the string "localhost". For additional filtering simultaneously - use the "[242]-allow host1,..." option to allow only specific hosts + use the "[246]-allow host1,..." option to allow only specific hosts in. This option is useful if you want to insure that no one can even begin a dialog with x11vnc from untrusted network interfaces (e.g. ppp0). - The option [243]-localhost now implies "-listen localhost" since that + The option [247]-localhost now implies "-listen localhost" since that is what most people expect it to do. @@ -2073,24 +2097,24 @@ ls -l "$file" interface, how I can occasionally allow in a non-localhost via the -R allowonce remote control command? - To do this specify "[244]-allow localhost". Unlike [245]-localhost + To do this specify "[248]-allow localhost". Unlike [249]-localhost this will leave x11vnc listening on all interfaces (but of course only allowing in local connections, e.g. ssh redirs). Then you can later run "x11vnc -R allowonce:somehost" or use to gui to permit a one-shot connection from a remote host. Note that if you do a lot of changing of the listening interface - ([246]-listen option) via remote control or gui, you may need to also - manually adjust the [247]-allow list if you unexpectedly get into a + ([250]-listen option) via remote control or gui, you may need to also + manually adjust the [251]-allow list if you unexpectedly get into a state where the allow list cannot match any hosts that would be coming - in on the listening interface. If you just toggle [248]-localhost on + in on the listening interface. If you just toggle [252]-localhost on and off x11vnc should see to it that you never get into such a state. Q-33: How can I tunnel my connection to x11vnc via an encrypted SSH channel between two Unix machines? - See the description earlier on this page on [249]how to tunnel VNC via + See the description earlier on this page on [253]how to tunnel VNC via SSH from Unix to Unix. A number of ways are described along with some issues you may encounter. @@ -2101,7 +2125,7 @@ ls -l "$file" Q-34: How can I tunnel my connection to x11vnc via an encrypted SSH channel from Windows using an SSH client like Putty? - [250]Above we described how to tunnel VNC via SSH from Unix to Unix, + [254]Above we described how to tunnel VNC via SSH from Unix to Unix, you may want to review it. To do this from Windows using Putty it would go something like this: * In the Putty dialog window under 'Session' enter the hostname or @@ -2124,8 +2148,8 @@ ls -l "$file" process in a BAT file including launching the VNC viewer by using the plink Putty utility. Send us the script if you get that working. - For extra protection feel free to run x11vnc with the [251]-localhost - and [252]-rfbauth/[253]-passwdfile options. + For extra protection feel free to run x11vnc with the [255]-localhost + and [256]-rfbauth/[257]-passwdfile options. If the machine you SSH into via Putty is not the same machine with the X display you wish to view (e.g. your company provides incoming SSH @@ -2133,11 +2157,11 @@ ls -l "$file" dialog setting to: 'Destination: otherhost:5900', Once logged in, you'll need to do a second login (ssh or rsh) to the workstation machine 'otherhost' and then start up x11vnc on it. This can also be - automated by [254]chaining ssh's. + automated by [258]chaining ssh's. - As discussed [255]above another option is to first start the VNC + As discussed [259]above another option is to first start the VNC viewer in "listen" mode, and then launch x11vnc with the - "[256]-connect localhost" option to establish the reverse connection. + "[260]-connect localhost" option to establish the reverse connection. In this case a Remote port redirection (not Local) is needed for port 5500 instead of 5900 (i.e. 'Source port: 5500' and 'Destination: localhost:5500' for a Remote connection). @@ -2148,7 +2172,7 @@ ls -l "$file" some clients view-only? How about running an arbitrary program to make the decisions? - Yes, look at the "[257]-accept command" option, it allows you to + Yes, look at the "[261]-accept command" option, it allows you to specify an external command that is run for each new client. (use quotes around the command if it contains spaces, etc.). If the external command returns 0 the client is accepted, otherwise the @@ -2167,7 +2191,7 @@ ls -l "$file" own simple popup window. To accept the client press "y" or click mouse on the "Yes" button. To reject the client press "n" or click mouse on the "No" button. To accept the client View-only, press "v" or click - mouse on the "View" button. If the [258]-viewonly option has been + mouse on the "View" button. If the [262]-viewonly option has been supplied, the "View" action will not be present: the whole display is view only in that case. @@ -2183,7 +2207,7 @@ ls -l "$file" program to prompt the user whether the client should be accepted or not. This requires that you have xmessage installed and available via PATH. In case it is not already on your system, the xmessage program - is available at [259]ftp://ftp.x.org/ + is available at [263]ftp://ftp.x.org/ To include view-only decisions for the external commands, prefix the command something like this: "yes:0,no:*,view:3 mycommand ..." This @@ -2222,7 +2246,7 @@ elif [ $rc = 4 ]; then fi exit 1 - Stefan Radman has written a nice dtksh script [260]dtVncPopup for use + Stefan Radman has written a nice dtksh script [264]dtVncPopup for use in CDE environments to do the same sort of thing. Information on how to use it is found at the top of the file. He encourages you to provide feedback to him to help improve the script. @@ -2231,7 +2255,7 @@ exit 1 popup is being run, so attached clients will not receive screen updates, etc during this period. - To run a command when a client disconnects, use the "[261]-gone + To run a command when a client disconnects, use the "[265]-gone command" option. This is for the user's convenience only: the return code of the command is not interpreted by x11vnc. The same environment variables are set as in "-accept command" (except that RFB_MODE will @@ -2246,13 +2270,13 @@ exit 1 such support. One approximate method involves starting x11vnc with the - [262]-localhost option. This basically requires the viewer user to log + [266]-localhost option. This basically requires the viewer user to log into the workstation where x11vnc is running via their Unix username and password, and then somehow set up a port redirection of his vncviewer connection to make it appear to emanate from the local machine. As discussed above, ssh is useful for this: "ssh -l username -L 5900:localhost:5900 hostname ..." See the ssh wrapper scripts - mentioned [263]elsewhere on this page. Of course a malicious user + mentioned [267]elsewhere on this page. Of course a malicious user could allow other users to get in through his channel, but that is a problem with every method. Another thing to watch out for is a malicious user on the viewer side (where ssh is running) trying to @@ -2261,7 +2285,7 @@ exit 1 Regarding limiting the set of Unix usernames who can connect, the traditional way would be to further require a VNC password to supplied (-rfbauth, -passwd, etc). A scheme that avoids a second password - involves using the [264]-accept option that runs a program to examine + involves using the [268]-accept option that runs a program to examine the connection information to determine which user is connecting from the local machine. For example, the program could use the ident service on the local machine (normally ident should not be trusted @@ -2294,7 +2318,7 @@ exit 1 # reject it display manager like gdm(1). Can I have x11vnc later switch to a different user? - As of Feb/2005 x11vnc has the [265]-users option that allows things + As of Feb/2005 x11vnc has the [269]-users option that allows things like this. Please read the documentation on it (also in the x11vnc -help output) carefully for features and caveats. It's use can often decrease security unless care is taken. @@ -2316,7 +2340,7 @@ exit 1 # reject it In any event, as of Jun/2004 there is an experimental utility to make it more difficult for nosey people to see your x11vnc activities. The - source for it is [266]blockdpy.c The idea behind it is simple (but + source for it is [270]blockdpy.c The idea behind it is simple (but obviously not bulletproof): when a VNC client attaches to x11vnc put the display monitor in the DPMS "off" state, if the DPMS state ever changes immediately start up the screen-lock program. The x11vnc user @@ -2332,8 +2356,8 @@ exit 1 # reject it bulletproof. A really robust solution would likely require X server and perhaps even video hardware support. - The blockdpy utility is launched by the [267]-accept option and told - to exit via the [268]-gone option (the vnc client user should + The blockdpy utility is launched by the [271]-accept option and told + to exit via the [272]-gone option (the vnc client user should obviously re-lock the screen before disconnecting!). Instructions can be found in the source code for the utility at the above link. @@ -2341,7 +2365,7 @@ exit 1 # reject it Q-39: Can I have x11vnc automatically lock the screen when I disconnect the VNC viewer? - Yes, a user mentions he uses the [269]-gone option under CDE to run a + Yes, a user mentions he uses the [273]-gone option under CDE to run a screen lock program: x11vnc -display :0 -forever -gone 'dtaction LockDisplay' @@ -2350,7 +2374,7 @@ exit 1 # reject it x11vnc -display :0 -forever -gone 'kdesktop_lock' x11vnc -display :0 -forever -gone 'xlock &' - Here is a scheme using the [270]-afteraccept option (in version 0.7.3) + Here is a scheme using the [274]-afteraccept option (in version 0.7.3) to unlock the screen after the first valid VNC login and to lock the screen after the last valid VNC login disconnects: x11vnc -display :0 -forever -shared -afteraccept ./myxlocker -gone ./myxlocke @@ -2389,11 +2413,11 @@ fi need to have sufficient permissions to connect to the X display. Here are some ideas: - * Use the description under "Continuously" in the [271]FAQ on x11vnc + * Use the description under "Continuously" in the [275]FAQ on x11vnc and Display Managers - * Use the description in the [272]FAQ on x11vnc and inetd(1) + * Use the description in the [276]FAQ on x11vnc and inetd(1) * Start x11vnc from your $HOME/.xsession (or $HOME/.xinitrc) - * Although less reliable, see the [273]x11vnc_loop rc.local hack + * Although less reliable, see the [277]x11vnc_loop rc.local hack below. The display manager scheme will not be specific to which user has the @@ -2424,7 +2448,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg while running x11vnc as root, e.g. for the gnome display manager, gdm: x11vnc -auth /var/gdm/:0.Xauth -display :0 - (the [274]-auth option sets the XAUTHORITY variable for you). + (the [278]-auth option sets the XAUTHORITY variable for you). There will be a similar thing for xdm using however a different auth directory path (perhaps something like @@ -2449,7 +2473,7 @@ x11vnc -logfile $HOME/.x11vnc.log -rfbauth $HOME/.vnc/passwd -forever -bg auth file should be in /var/dt), you'll also need to add something like Dtlogin*grabServer:False to the Xconfig file (/etc/dt/config/Xconfig or /usr/dt/config/Xconfig on Solaris, see - [275]the example at the end of this FAQ). Then restart dtlogin, e.g.: + [279]the example at the end of this FAQ). Then restart dtlogin, e.g.: /etc/init.d/dtlogin stop; /etc/init.d/dtlogin start or reboot. Continuously. Have x11vnc reattach each time the X server is @@ -2512,7 +2536,7 @@ rever -bg Then restart: /usr/sbin/gdm-restart (or reboot). The KillInitClients=false setting is important: without it x11vnc will be - killed immediately after the user logs in. Here are [276]full details + killed immediately after the user logs in. Here are [280]full details on how to configure gdm _________________________________________________________________ @@ -2554,13 +2578,13 @@ rever -bg If you do not want to deal with any display manager startup scripts, here is a kludgey script that can be run manually or out of a boot - file like rc.local: [277]x11vnc_loop It will need some local + file like rc.local: [281]x11vnc_loop It will need some local customization before running. Because the XAUTHORITY auth file must be guessed by this script, use of the display manager script method described above is greatly preferred. If the machine is a traditional Xterminal you may want to read - [278]this FAQ. + [282]this FAQ. Q-42: Can I run x11vnc out of inetd(1)? How about xinetd(1)? @@ -2570,7 +2594,7 @@ rever -bg 5900 stream tcp nowait root /usr/sbin/tcpd /usr/local/bin/x11vnc_sh - where the shell script /usr/local/bin/x11vnc_sh uses the [279]-inetd + where the shell script /usr/local/bin/x11vnc_sh uses the [283]-inetd option and looks something like (you'll need to customize to your settings). #!/bin/sh @@ -2583,7 +2607,7 @@ rever -bg and that confuses it greatly, causing it to abort). If you do not use a wrapper script as above but rather call x11vnc directly in /etc/inetd.conf and do not redirect stderr to a file, then you must - specify the -q (aka [280]-quiet) option: "/usr/local/bin/x11vnc -q + specify the -q (aka [284]-quiet) option: "/usr/local/bin/x11vnc -q -inetd ...". When you supply both -q and -inet and no "-o logfile" then stderr will automatically be closed (to prevent, e.g. library stderr messages leaking out to the viewer). The recommended practice @@ -2591,7 +2615,7 @@ rever -bg script with "2>logfile" redirection because the errors and warnings printed out are very useful in troubleshooting problems. - Note also the need to set XAUTHORITY via [281]-auth to point to the + Note also the need to set XAUTHORITY via [285]-auth to point to the MIT-COOKIE auth file to get permission to connect to the X display (setting and exporting the XAUTHORITY variable accomplishes the same thing). See the x11vnc_loop file in the previous question for more @@ -2659,7 +2683,7 @@ service x11vncservice web browser? To have x11vnc serve up a Java VNC viewer applet to any web browsers - that connect to it, run x11vnc with this [282]option: + that connect to it, run x11vnc with this [286]option: -httpdir /path/to/the/java/classes/dir (this directory will contain the files index.vnc and, for example, @@ -2678,7 +2702,7 @@ service x11vncservice then you can connect to that URL with any Java enabled browser. Feel free to customize the default index.vnc file in the classes directory. - As of May/2005 the [283]-http option will try to guess where the Java + As of May/2005 the [287]-http option will try to guess where the Java classes jar file is by looking a expected locations. Also note that if you wanted to, you could also start the Java viewer @@ -2692,7 +2716,7 @@ service x11vncservice As of Mar/2004 in the libvncserver CVS x11vnc supports reverse connections. On Unix one starts the VNC viewer in listen mode: vncviewer -listen (see your documentation for Windows, etc), and then - starts up x11vnc with the [284]-connect option. To connect immediately + starts up x11vnc with the [288]-connect option. To connect immediately at x11vnc startup time use the "-connect host:port" option (use commas for a list of hosts to connect to). The ":port" is optional (default is 5500). If a file is specified instead: -connect /path/to/some/file @@ -2700,7 +2724,7 @@ service x11vncservice hosts to connect to. To use the vncconnect(1) program (from the core VNC package at - www.realvnc.com) specify the [285]-vncconnect option to x11vnc (Note: + www.realvnc.com) specify the [289]-vncconnect option to x11vnc (Note: as of Dec/2004 -vncconnect is now the default). vncconnect(1) must be pointed to the same X11 DISPLAY as x11vnc (since it uses X properties to communicate with x11vnc). If you do not have or do not want to get @@ -2744,7 +2768,7 @@ xprop -root -f VNC_CONNECT 8s -set VNC_CONNECT "$1" There are some annoyances WRT Xvfb though. The default keyboard mapping seems to be very poor. One should run x11vnc with - [286]-add_keysyms option to have keysyms added automatically. Also, to + [290]-add_keysyms option to have keysyms added automatically. Also, to add the Shift_R and Control_R modifiers something like this is needed: #!/bin/sh xmodmap -e "keycode any = Shift_R" @@ -2766,11 +2790,11 @@ xmodmap -e "add Control = Control_L Control_R" The main drawback to this method (besides requiring extra configuration and possibly root permission) is that it also does the - Linux Virtual Console/Terminal (VC/VT) [287]switching even though it + Linux Virtual Console/Terminal (VC/VT) [291]switching even though it does not need to (since it doesn't use a real framebuffer). There are some "dual headed" (actually multi-headed/multi-user) patches to the X server that turn off the VT usage in the X server. Update: As of - Jul/2005 we have an LD_PRELOAD script [288]Xdummy that allows you to + Jul/2005 we have an LD_PRELOAD script [292]Xdummy that allows you to use a stock (i.e. unpatched) Xorg or XFree86 server with the "dummy" driver and not have any VT switching problems! Currently Xdummy needs to be run as root, but with some luck that may be relaxed in the @@ -2802,7 +2826,7 @@ startx -- /path/to/Xdummy :1 An X server can be started on the headless machine (sometimes this requires configuring the X server to not fail if it cannot detect a keyboard or mouse, see the next paragraph). Then you can export that X - display via x11vnc (e.g. see [289]this FAQ) and access it from + display via x11vnc (e.g. see [293]this FAQ) and access it from anywhere on the network via a VNC viewer. Some tips on getting X servers to start on machines without keyboard @@ -2845,7 +2869,7 @@ startx -- /path/to/Xdummy :1 19/03/2004 10:10:58 error creating tile-row shm for len=4 19/03/2004 10:10:58 reverting to single_copytile mode - Here is a shell script [290]shm_clear to list and prompt for removal + Here is a shell script [294]shm_clear to list and prompt for removal of your unattached shm segments (attached ones are skipped). I use it while debugging x11vnc (I use "shm_clear -y" to assume "yes" for each prompt). If x11vnc is regularly not cleaning up its shm segments, @@ -2879,36 +2903,36 @@ ied) in /etc/system. See the next paragraph for more workarounds. To minimize the number of shm segments used by x11vnc try using the - [291]-onetile option (corresponds to only 3 shm segments used, and + [295]-onetile option (corresponds to only 3 shm segments used, and adding -fs 1.0 knocks it down to 2). If you are having much trouble with shm segments, consider disabling shm completely via the - [292]-noshm option. Performance will be somewhat degraded but when + [296]-noshm option. Performance will be somewhat degraded but when done over local machine sockets it should be acceptable (see an - [293]earlier question discussing -noshm). + [297]earlier question discussing -noshm). Q-48: How can I make x11vnc use less system resources? - The [294]-nap and "[295]-wait n" (where n is the sleep between polls + The [298]-nap and "[299]-wait n" (where n is the sleep between polls in milliseconds, the default is 30 or so) option are good places to start. Reducing the X server bits per pixel depth (e.g. to 16bpp or even 8bpp) will further decrease memory I/O and network I/O. The ShadowFB will make x11vnc's screen polling less severe. Using the - [296]-onetile option will use less memory and use fewer shared memory - slots (add [297]-fs 1.0 for one less slot). + [300]-onetile option will use less memory and use fewer shared memory + slots (add [301]-fs 1.0 for one less slot). Q-49: How can I make x11vnc use MORE system resources? - You can try [298]-threads and dial down the wait time (e.g. -wait 1) - and possibly dial down [299]-defer as well. Note that if you try to + You can try [302]-threads and dial down the wait time (e.g. -wait 1) + and possibly dial down [303]-defer as well. Note that if you try to increase the "frame rate" too much you can bog down the server end with the extra work it needs to do compressing the framebuffer data, etc. That said, it is possible to "stream" video via x11vnc if the video window is small enough. E.g. a 256x192 xawtv TV capture window (using - the x11vnc [300]-id option) can be streamed over a LAN or wireless at + the x11vnc [304]-id option) can be streamed over a LAN or wireless at a reasonable frame rate. @@ -2924,16 +2948,16 @@ ied) * Use a smaller desktop size (e.g. 1024x768 instead of 1280x1024) * Make sure the desktop background is a solid color (the background is resent every time it is re-exposed). Consider using the - [301]-solid [color] option to try to do this automatically. + [305]-solid [color] option to try to do this automatically. * Configure your window manager or desktop "theme" to not use fancy images, shading, and gradients for the window decorations, etc. Disable window animations, etc. Maybe your desktop has a "low bandwidth" theme you can easily switch into and out of. * Avoid small scrolls of large windows using the Arrow keys or scrollbar. Try to use PageUp/PageDown instead. (not so much of a - problem in x11vnc 0.7.2 if [302]-scrollcopyrect is active and + problem in x11vnc 0.7.2 if [306]-scrollcopyrect is active and detecting scrolls for the application). - * If the [303]-wireframe option is not available (earlier than + * If the [307]-wireframe option is not available (earlier than x11vnc 0.7.2 or you have disabled it via -nowireframe) then Disable Opaque Moves and Resizes in the window manager/desktop. * However if -wireframe is active (on by default in x11vnc 0.7.2) @@ -2953,7 +2977,7 @@ ied) noticed. VNC viewer parameters: - * Use a [304]TightVNC enabled viewer! (Actually, RealVNC 4.x viewer + * Use a [308]TightVNC enabled viewer! (Actually, RealVNC 4.x viewer with ZRLE encoding is not too bad either; some claim it is faster). * Make sure the tight (or zrle) encoding is being used (look at @@ -2976,28 +3000,28 @@ ied) file. x11vnc parameters: - * Try using [305]-nodragging (no screen updates when dragging mouse, + * Try using [309]-nodragging (no screen updates when dragging mouse, but sometimes you miss visual feedback) - * Make sure the [306]-wireframe option is active (it should be on by + * Make sure the [310]-wireframe option is active (it should be on by default) and you have Opaque Moves/Resizes Enabled in the window manager. - * Make sure the [307]-scrollcopyrect option is active (it should be + * Make sure the [311]-scrollcopyrect option is active (it should be on by default). This detects scrolls in many (but not all) applications an applies the CopyRect encoding for a big speedup. - * Set [308]-fs 1.0 (disables fullscreen updates) - * Try increasing [309]-wait or [310]-defer (reduces the maximum + * Set [312]-fs 1.0 (disables fullscreen updates) + * Try increasing [313]-wait or [314]-defer (reduces the maximum "frame rate", but won't help much for large screen changes) - * Try the [311]-progressive pixelheight mode with the block + * Try the [315]-progressive pixelheight mode with the block pixelheight 100 or so (delays sending vertical blocks since they may change while viewer is receiving earlier ones) - * If you just want to watch one (simple) window use [312]-id (cuts + * If you just want to watch one (simple) window use [316]-id (cuts down extraneous polling and updates, but can be buggy or insufficient) - * Set [313]-nosel (disables all clipboard selection exchange) - * Use [314]-nocursor and [315]-nocursorpos (repainting the remote + * Set [317]-nosel (disables all clipboard selection exchange) + * Use [318]-nocursor and [319]-nocursorpos (repainting the remote cursor position and shape takes resources and round trips) * On very slow links (e.g. <= 28.8) you may need to increase the - [316]-readtimeout n setting if it sometimes takes more than 20sec + [320]-readtimeout n setting if it sometimes takes more than 20sec to paint the full screen, etc. @@ -3019,7 +3043,7 @@ ied) Note that the DAMAGE extension does not speed up the actual reading of pixels from the video card framebuffer memory, by, say, mirroring them - in main memory. So reading the fb is still painfully [317]slow (e.g. + in main memory. So reading the fb is still painfully [321]slow (e.g. 5MB/sec), and so even using X DAMAGE when large changes occur on the screen the bulk of the time is still spent retrieving them. Not ideal, but use of the ShadowFB XFree86/Xorg option speeds up the reading @@ -3037,27 +3061,27 @@ ied) DAMAGE rectangles to contain real damage. The larger rectangles are only used as hints to focus the traditional scanline polling (i.e. if a scanline doesn't intersect a recent DAMAGE rectangle, the scan is - skipped). You can use the "[318]-xd_area A" option to adjust the size + skipped). You can use the "[322]-xd_area A" option to adjust the size of the trusted DAMAGE rectangles. The default is 20000 pixels (e.g. a 140x140 square, etc). Use "-xd_area 0" to disable the cutoff and trust all DAMAGE rectangles. - The option "[319]-xd_mem f" may also be of use in tuning the - algorithm. To disable using DAMAGE entirely use "[320]-noxdamage". + The option "[323]-xd_mem f" may also be of use in tuning the + algorithm. To disable using DAMAGE entirely use "[324]-noxdamage". Q-52: When I drag windows around with the mouse or scroll up and down things really bog down (unless I do the drag in a single, quick motion). Is there anything to do to improve things? - This problem is primarily due to [321]slow hardware read rates from + This problem is primarily due to [325]slow hardware read rates from video cards: as you scroll or move a large window around the screen changes are much too rapid for x11vnc to keep up them (it can usually only read the video card at about 5-10 MB/sec, so it can take a good fraction of a second to read the changes induce from moving a large window, if this to be done a number of times in succession the window or scroll appears to "lurch" forward). See the description in the - [322]-pointer_mode option for more info. The next bottleneck is + [326]-pointer_mode option for more info. The next bottleneck is compressing all of these changes and sending them out to connected viewers, however the VNC protocol is pretty much self-adapting with respect to that (updates are only packaged and sent when viewers ask @@ -3067,26 +3091,26 @@ ied) tree. The default should now be much better than before and dragging small windows around should no longer be a huge pain. If for some reason these changes make matters worse, you can go back to the old - way via the "[323]-pointer_mode 1" option. + way via the "[327]-pointer_mode 1" option. - Also added was the [324]-nodragging option that disables all screen + Also added was the [328]-nodragging option that disables all screen updates while dragging with the mouse (i.e. mouse motion with a button held down). This gives the snappiest response, but might be undesired in some circumstances when you want to see the visual feedback while dragging (e.g. menu traversal or text selection). - As of Dec/2004 in the libvncserver CVS the [325]-pointer_mode n option + As of Dec/2004 in the libvncserver CVS the [329]-pointer_mode n option was introduced. n=1 is the original mode, n=2 an improvement, etc.. See the -pointer_mode n help for more info. - Also, in some circumstances the [326]-threads option can improve + Also, in some circumstances the [330]-threads option can improve response considerably. Be forewarned that if more than one vncviewer is connected at the same time then libvncserver may not be thread safe (try to get the viewers to use different VNC encodings, e.g. tight and ZRLE). As of Apr/2005 in the libvncserver CVS two new options (see the - [327]wireframe FAQ and [328]scrollcopyrect FAQ below) provide schemes + [331]wireframe FAQ and [332]scrollcopyrect FAQ below) provide schemes to sweep this problem under the rug for window moves or resizes and for some (but not all) window scrolls. @@ -3102,8 +3126,8 @@ ied) shown. When the window move/resize stops, it returns to normal processing: you should only see the window appear in the new position. This spares you from interacting with a "lurching" window between all - of the intermediate steps. BTW the lurching is due to [329]slow video - card read rates (see [330]here too). A displacement, even a small one, + of the intermediate steps. BTW the lurching is due to [333]slow video + card read rates (see [334]here too). A displacement, even a small one, of a large window requires a non-negligible amount of time, a good fraction of a second, to read in from the hardware framebuffer. @@ -3111,7 +3135,7 @@ ied) for -wireframe to do any good. The mode is currently on by default because most people are inflicted - with the problem. It can be disabled with the [331]-nowireframe option + with the problem. It can be disabled with the [335]-nowireframe option (aka -nowf). Why might one want to turn off the wireframing? Since x11vnc is merely guessing when windows are being moved/resized, it may guess poorly for your window-manager or desktop, or even for the way @@ -3156,13 +3180,13 @@ ied) * Maximum time to show a wireframe animation. * Minimum time between sending wireframe outlines. - See the [332]"-wireframe tweaks" option for more details. On a slow + See the [336]"-wireframe tweaks" option for more details. On a slow link, e.g. dialup modem, the parameters may be automatically adjusted for better response. CopyRect encoding: In addition to the above there is the - [333]"-wirecopyrect mode" option. It is also on by default. This + [337]"-wirecopyrect mode" option. It is also on by default. This instructs x11vnc to not only show the wireframe animation, but to also instruct all connected VNC viewers to locally translate the window image data from the original position to the new position on the @@ -3210,7 +3234,7 @@ ied) requiring the image data to be transmitted over the network. For fast links the speedup is primarily due to x11vnc not having to read the scrolled framebuffer data from the X server (recall that reading from - the hardware framebuffer is [334]slow). + the hardware framebuffer is [338]slow). To do this x11vnc uses the RECORD X extension to snoop the X11 protocol between the X client with the focus window and the X server. @@ -3232,10 +3256,10 @@ ied) the X server display: if one falls too far behind it could become a mess... - The initial implementation of [335]-scrollcopyrect option is useful in + The initial implementation of [339]-scrollcopyrect option is useful in that it detects many scrolls and thus gives a much nicer working - environment (especially when combined with the [336]-wireframe - [337]-wirecopyrect [338]options, which are also on by default; and if + environment (especially when combined with the [340]-wireframe + [341]-wirecopyrect [342]options, which are also on by default; and if you are willing to enable the ShadowFB things are very fast). The fact that there aren't long delays or lurches during scrolling is the primary improvement. @@ -3268,10 +3292,10 @@ ied) One can tap the Alt_L key (Left "Alt" key) 3 times in a row to signal x11vnc to refresh the screen to all viewers. Your VNC-viewer may have its own screen refresh hot-key or button. See - also: [339]-fixscreen + also: [343]-fixscreen * Some applications, notably OpenOffice, do XCopyArea scrolls in weird ways that assume ancestor window clipping is taking place. - See the [340]-scr_skip option for ways to tweak this on a + See the [344]-scr_skip option for ways to tweak this on a per-application basis. * Selecting text while dragging the mouse may be slower, especially if the Button-down event happens near the window's edge. This is @@ -3288,7 +3312,7 @@ ied) because it fails to detect scrolls in it. Sometimes clicking inside the application window or selecting some text in it to force the focus helps. - * When using the [341]-scale option there will be a quick CopyRect + * When using the [345]-scale option there will be a quick CopyRect scroll, but it needs to be followed by a slower "cleanup" update. This is because for a fixed finite screen resolution (e.g. 75 dpi) scaling and copyrect-ing are not exactly independent. Scaling @@ -3301,7 +3325,7 @@ ied) If you find the -scrollcopyrect behavior too approximate or distracting you can go back to the standard polling-only update method - with the [342]-noscrollcopyrect (or -noscr for short). If you find + with the [346]-noscrollcopyrect (or -noscr for short). If you find some extremely bad and repeatable behavior for -scrollcopyrect please report a bug. @@ -3340,16 +3364,16 @@ ied) this is because the cursor shape is often downloaded to the graphics hardware (video card), but I could be mistaken. - A simple kludge is provided by the "[343]-cursor X" option that + A simple kludge is provided by the "[347]-cursor X" option that changes the cursor when the mouse is on the root background (or any window has the same cursor as the root background). Note that desktops like GNOME or KDE often cover up the root background, so this won't - work for those cases. Also see the "[344]-cursor some" option for + work for those cases. Also see the "[348]-cursor some" option for additional kludges. Note that as of Aug/2004 in the libvncserver CVS, on Solaris using the SUN_OVL overlay extension and IRIX, x11vnc can show the correct mouse - cursor when the [345]-overlay option is supplied. See [346]this FAQ + cursor when the [349]-overlay option is supplied. See [350]this FAQ for more info. Also as of Dec/2004 in the libvncserver CVS XFIXES X extension support @@ -3357,7 +3381,7 @@ ied) XFIXES fixes the problem of the cursor-shape being write-only: x11vnc can now query the X server for the current shape and send it back to the connected viewers. XFIXES is available on recent Linux Xorg based - distros and [347]Solaris 10. + distros and [351]Solaris 10. The only XFIXES issue is the handling of alpha channel transparency in cursors. If a cursor has any translucency then in general it must be @@ -3365,7 +3389,7 @@ ied) situations where the cursor transparency can also handled exactly: when the VNC Viewer requires the cursor shape be drawn into the VNC framebuffer or if you apply a patch to your VNC Viewer to extract - hidden alpha channel data under 32bpp. [348]Details can be found here. + hidden alpha channel data under 32bpp. [352]Details can be found here. Q-56: When using XFIXES cursorshape mode, some of the cursors look @@ -3398,17 +3422,17 @@ ied) for most cursor themes and you don't have to worry about it. In case it still looks bad for your cursor theme, there are (of - course!) some tunable parameters. The "[349]-alphacut n" option lets + course!) some tunable parameters. The "[353]-alphacut n" option lets you set the threshold "n" (between 0 and 255): cursor pixels with alpha values below n will be considered completely transparent while values equal to or above n will be completely opaque. The default is - 240. The "[350]-alphafrac f" option tries to correct individual + 240. The "[354]-alphafrac f" option tries to correct individual cursors that did not fare well with the default -alphacut value: if a cursor has less than fraction f (between 0.0 and 1.0) of its pixels selected by the default -alphacut, the threshold is lowered until f of its pixels are selected. The default fraction is 0.33. - Finally, there is an option [351]-alpharemove that is useful for + Finally, there is an option [355]-alpharemove that is useful for themes where many cursors are light colored (e.g. "whiteglass"). XFIXES returns the cursor data with the RGB values pre-multiplied by the alpha value. If the white cursors look too grey, specify @@ -3434,11 +3458,11 @@ ied) send the alpha channel data to libvncserver. However, this data will only be used for VNC clients that do not support the CursorShapeUpdates VNC extension (or have disabled it). It can be - disabled for all clients with the [352]-nocursorshape x11vnc option. + disabled for all clients with the [356]-nocursorshape x11vnc option. In this case the cursor is drawn, correctly blended with the background, into the VNC framebuffer before being sent out to the client. So the alpha blending is done on the x11vnc side. Use the - [353]-noalphablend option to disable this behavior (always approximate + [357]-noalphablend option to disable this behavior (always approximate transparent cursors with opaque RGB values). The CursorShapeUpdates VNC extension complicates matters because the @@ -3466,9 +3490,9 @@ ied) Q-58: Why does the mouse arrow just stay in one corner in my vncviewer, whereas my cursor (that does move) is just a dot? - This default takes advantage of a [354]tightvnc extension + This default takes advantage of a [358]tightvnc extension (CursorShapeUpdates) that allows specifying a cursor image shape for - the local VNC viewer. You may disable it with the [355]-nocursor + the local VNC viewer. You may disable it with the [359]-nocursor option to x11vnc if your viewer does not have this extension. Note: as of Aug/2004 in the libvncserver CVS this should be fixed: the @@ -3482,18 +3506,18 @@ ied) clients (i.e. passive viewers can see the mouse cursor being moved around by another viewer)? - Use the [356]-cursorpos option when starting x11vnc. A VNC viewer must + Use the [360]-cursorpos option when starting x11vnc. A VNC viewer must support the Cursor Positions Updates for the user to see the mouse motions (the TightVNC viewers support this). As of Aug/2004 in the - libvncserver CVS -cursorpos is the default. See also [357]-nocursorpos - and [358]-nocursorshape. + libvncserver CVS -cursorpos is the default. See also [361]-nocursorpos + and [362]-nocursorshape. Q-60: Is it possible to swap the mouse buttons (e.g. left-handed operation), or arbitrarily remap them? How about mapping button clicks to keystrokes, e.g. to partially emulate Mouse wheel scrolling? - You can remap the mouse buttons via something like: [359]-buttonmap + You can remap the mouse buttons via something like: [363]-buttonmap 13-31 (or perhaps 12-21). Also, note that xmodmap(1) lets you directly adjust the X server's button mappings, but in some circumstances it might be more desirable to have x11vnc do it. @@ -3501,7 +3525,7 @@ ied) One user had an X server with only one mouse button(!) and was able to map all of the VNC client mouse buttons to it via: -buttonmap 123-111. - Note that the [360]-debug_pointer option prints out much info for + Note that the [364]-debug_pointer option prints out much info for every mouse/pointer event and is handy in solving problems. To map mouse button clicks to keystrokes you can use the alternate @@ -3523,7 +3547,7 @@ ied) Exactly what keystroke "scrolling" events they should be bound to depends on one's taste. If this method is too approximate, one could - consider not using [361]-buttonmap but rather configuring the X server + consider not using [365]-buttonmap but rather configuring the X server to think it has a mouse with 5 buttons even though the physical mouse does not. (e.g. 'Option "ZAxisMapping" "4 5"'). @@ -3553,7 +3577,7 @@ ied) Q-61: How can I get my AltGr and Shift modifiers to work between keyboards for different languages? - The option [362]-modtweak should help here. It is a mode that monitors + The option [366]-modtweak should help here. It is a mode that monitors the state of the Shift and AltGr Modifiers and tries to deduce the correct keycode to send, possibly by sending fake modifier key presses and releases in addition to the actual keystroke. @@ -3562,17 +3586,17 @@ ied) default (use -nomodtweak to get the old behavior). This was done because it was noticed on newer XFree86 setups even on bland "us" keyboards like "pc104 us" XFree86 included a "ghost" key with both "<" - and ">" it. This key does not exist on the keyboard (see [363]this FAQ + and ">" it. This key does not exist on the keyboard (see [367]this FAQ for more info). Without -modtweak there was then an ambiguity in the reverse map keysym => keycode, making it so the "<" symbol could not be typed. - Also see the [364]FAQ about the -xkb option for a more powerful method + Also see the [368]FAQ about the -xkb option for a more powerful method of modifier tweaking for use on X servers with the XKEYBOARD extension. When trying to resolve keyboard mapping problems, note that the - [365]-debug_keyboard option prints out much info for every keystroke + [369]-debug_keyboard option prints out much info for every keystroke and so can be useful debugging things. @@ -3584,9 +3608,9 @@ ied) (e.g. pc105 in the XF86Config file when it should be something else, say pc104). - Short Cut: Try the [366]-xkb or [367]-sloppy_keys options and see if + Short Cut: Try the [370]-xkb or [371]-sloppy_keys options and see if that helps the situation. The discussion below is a bit outdated (e.g. - [368]-modtweak is now the default) but is useful reference for various + [372]-modtweak is now the default) but is useful reference for various tricks and so is kept. @@ -3629,17 +3653,17 @@ ied) -remap less-comma These are convenient in that they do not modify the actual X server - settings. The former ([369]-modtweak) is a mode that monitors the + settings. The former ([373]-modtweak) is a mode that monitors the state of the Shift and AltGr modifiers and tries to deduce the correct keycode sequence to send. Since Jul/2004 -modtweak is now the default. - The latter ([370]-remap less-comma) is an immediate remapping of the + The latter ([374]-remap less-comma) is an immediate remapping of the keysym less to the keysym comma when it comes in from a client (so when Shift is down the comma press will yield "<"). - See also the [371]FAQ about the -xkb option as a possible workaround + See also the [375]FAQ about the -xkb option as a possible workaround using the XKEYBOARD extension. - Note that the [372]-debug_keyboard option prints out much info for + Note that the [376]-debug_keyboard option prints out much info for every keystroke to aid debugging keyboard problems. @@ -3647,13 +3671,13 @@ ied) (i.e. an extra comma). This is likely because you press "Shift" then "<" but then released - the Shift key before releasing the "<". Because of a [373]keymapping + the Shift key before releasing the "<". Because of a [377]keymapping ambiguity the last event "< up" is interpreted as "," because that key unshifted is the comma. - This should not happen in [374]-xkb mode, because it works hard to + This should not happen in [378]-xkb mode, because it works hard to resolve the ambiguities. If you do not want to use -xkb, try the - option [375]-sloppy_keys to attempt a similar type of algorithm. + option [379]-sloppy_keys to attempt a similar type of algorithm. Q-64: I'm using an "international" keyboard (e.g. German "de", or @@ -3677,7 +3701,7 @@ ied) In both cases no AltGr is sent to the VNC server, but we know AltGr is needed on the physical international keyboard to type a "@". - This all worked fine with x11vnc running with the [376]-modtweak + This all worked fine with x11vnc running with the [380]-modtweak option (it figures out how to adjust the Modifier keys (Shift or AltGr) to get the "@"). However it fails under recent versions of XFree86 (and the X.org fork). These run the XKEYBOARD extension by @@ -3695,7 +3719,7 @@ ied) * there is a new option -xkb to use the XKEYBOARD extension API to do the Modifier key tweaking. - The [377]-xkb option seems to fix all of the missing keys: "@", "<", + The [381]-xkb option seems to fix all of the missing keys: "@", "<", ">", etc.: it is recommended that you try it if you have this sort of problem. Let us know if there are any remaining problems (see the next paragraph for some known problems). If you specify the -debug_keyboard @@ -3703,7 +3727,7 @@ ied) debugging output (send it along with any problems you report). Update: as of Jun/2005 x11vnc will try to automatically enable - [378]-xkb if it appears that would be beneficial (e.g. if it sees any + [382]-xkb if it appears that would be beneficial (e.g. if it sees any of "@", "<", ">", "[" and similar keys are mapped in a way that needs the -xkb to access them). To disable this automatic check use -noxkb. @@ -3718,7 +3742,7 @@ ied) was attached to keycode 93 (no physical key generates this keycode) while ISO_Level3_Shift was attached to keycode 113. The keycode skipping option was used to disable the ghost key: - [379]-skip_keycodes 93 + [383]-skip_keycodes 93 * In implementing -xkb we noticed that some characters were still not getting through, e.g. "~" and "^". This is not really an XKEYBOARD problem. What was happening was the VNC viewer was @@ -3735,16 +3759,16 @@ ied) What to do? In general the VNC protocol has not really solved this problem: what should be done if the VNC viewer sends a keysym not recognized by the VNC server side? Workarounds can possibly be - created using the [380]-remap x11vnc option: + created using the [384]-remap x11vnc option: -remap asciitilde-dead_tilde,asciicircum-dead_circumflex etc. Use -remap filename if the list is long. Please send us your workarounds for this problem on your keyboard. Perhaps we can have x11vnc adjust automatically at some point. Also see the - [381]-add_keysyms option in the next paragraph. - Update: for convenience "[382]-remap DEAD" does many of these + [385]-add_keysyms option in the next paragraph. + Update: for convenience "[386]-remap DEAD" does many of these mappings at once. - * To complement the above workaround using the [383]-remap, an - option [384]-add_keysyms was added. This option instructs x11vnc + * To complement the above workaround using the [387]-remap, an + option [388]-add_keysyms was added. This option instructs x11vnc to bind any unknown Keysyms coming in from VNC viewers to unused Keycodes in the X server. This modifies the global state of the X server. When x11vnc exits it removes the extra keymappings it @@ -3763,7 +3787,7 @@ ied) Short answer: disable key autorepeating by running the command "xset r off" on the Xserver where x11vnc is run (restore via "xset r on") or - use the new (Jul/2004) [385]-norepeat x11vnc option. You will still + use the new (Jul/2004) [389]-norepeat x11vnc option. You will still have autorepeating because that is taken care of on your VNC viewer side. @@ -3787,7 +3811,7 @@ ied) off", does the problem go away? The workaround is to manually apply "xset r off" and "xset r on" as - needed, or to use the [386]-norepeat (which has since Dec/2004 been + needed, or to use the [390]-norepeat (which has since Dec/2004 been made the default). Note that with X server autorepeat turned off the VNC viewer side of the connection will (nearly always) do its own autorepeating so there is no big loss here, unless someone is also @@ -3798,7 +3822,7 @@ ied) keystrokes!! Are you using x11vnc to log in to an X session? (as described in - [387]this FAQ) If so, x11vnc is starting before your session and it + [391]this FAQ) If so, x11vnc is starting before your session and it disables autorepeat when you connect, but then after you log in your session startup (GNOME, KDE, ...) could be resetting the autorepeat to be on. Or it could be something inside your desktop trying to be @@ -3822,7 +3846,7 @@ ied) machine where I run the VNC viewer does not. Is there a way I can map a local unused key to send an AltGr? How about a Compose key as well? - Something like "[388]-remap Super_R-Mode_switch" x11vnc option may + Something like "[392]-remap Super_R-Mode_switch" x11vnc option may work. Note that Super_R is the "Right Windoze(tm) Flaggie" key; you may want to choose another. The -debug_keyboard option comes in handy in finding keysym names (so does xev(1)). @@ -3845,7 +3869,7 @@ ied) Since xmodmap(1) modifies the X server mappings you may not want to do this (because it affects local work on that machine). Something like - the [389]-remap Alt_L-Meta_L to x11vnc may be sufficient for ones + the [393]-remap Alt_L-Meta_L to x11vnc may be sufficient for ones needs, and does not modify the X server environment. Note that you cannot send Alt_L in this case, maybe -remap Super_L-Meta_L would be a better choice if the Super_L key is typically unused in Unix. @@ -3856,7 +3880,7 @@ ied) This can be done directly in some X servers using AccessX and Pointer_EnableKeys, but is a bit awkward. It may be more convenient to - have x11vnc do the remapping. This can be done via the [390]-remap + have x11vnc do the remapping. This can be done via the [394]-remap option using the fake "keysyms" Button1, Button2, etc. as the "to" keys (i.e. the ones after the "-") @@ -3865,7 +3889,7 @@ ied) button "paste" because (using XFree86/Xorg Emulate3Buttons) you have to click both buttons on the touch pad at the same time. This remapping: - [391]-remap Super_R-Button2 + [395]-remap Super_R-Button2 maps the Super_R "flag" key press to the Button2 click, thereby making X pasting a bit easier. @@ -3895,7 +3919,7 @@ ied) There may also be scaling viewers out there (e.g. TightVNC or UltraVNC on Windows) that automatically shrink or expand the remote framebuffer to fit the local display. Especially for hand-held devices. See also - [392]this FAQ on x11vnc scaling. + [396]this FAQ on x11vnc scaling. Q-71: Does x11vnc support server-side framebuffer scaling? (E.g. to @@ -3903,7 +3927,7 @@ ied) As of Jun/2004 in the libvncserver CVS x11vnc provides basic server-side scaling. It is a global scaling of the desktop, not a - per-client setting. To enable it use the "[393]-scale fraction" + per-client setting. To enable it use the "[397]-scale fraction" option. "fraction" can either be a floating point number (e.g. -scale 0.5) or the alternative m/n fraction notation (e.g. -scale 2/3). Note that if fraction is greater than one the display is magnified. @@ -3924,7 +3948,7 @@ ied) One can also use the ":nb" with an integer scale factor (say "-scale 2:nb") to use x11vnc as a screen magnifier for vision impaired - [394]applications. Since with integer scale factors the framebuffers + [398]applications. Since with integer scale factors the framebuffers become huge and scaling operations time consuming, be sure to use ":nb" for the fastest response. @@ -3950,12 +3974,12 @@ ied) If one desires per-client scaling for something like 1:1 from a workstation and 1:2 from a smaller device (e.g. handheld), currently the only option is to run two (or more) x11vnc processes with - different scalings listening on separate ports ([395]-rfbport option, + different scalings listening on separate ports ([399]-rfbport option, etc.). BTW, whenever you run two or more x11vnc's on the same X display and - use the [396]GUI, then to avoid all of the x11vnc's simultaneously - answering the gui you will need to use something like [397]"-connect + use the [400]GUI, then to avoid all of the x11vnc's simultaneously + answering the gui you will need to use something like [401]"-connect file1 -gui ..." with different connect files for each x11vnc you want to control via the gui (or remote-control). The "-connect file1" usage gives separate communication channels between a x11vnc proces and the @@ -3964,7 +3988,7 @@ ied) Update: As of Mar/2005 in the libvncserver CVS x11vnc now scales the mouse cursor with the same scale factor as the screen. If you don't - want that, use the [398]"-scale_cursor frac" option to set the cursor + want that, use the [402]"-scale_cursor frac" option to set the cursor scaling to a different factor (e.g. use "-scale_cursor 1" to keep the cursor at its natural unscaled size). @@ -3986,16 +4010,16 @@ ied) screen is not rectangular (e.g. 1280x1024 and 1024x768 monitors joined together), then there will be "non-existent" areas on the screen. The X server will return "garbage" image data for these areas and so they - may be distracting to the viewer. The [399]-blackout x11vnc option + may be distracting to the viewer. The [403]-blackout x11vnc option allows you to blacken-out rectangles by manually specifying their WxH+X+Y geometries. If your system has the libXinerama library, the - [400]-xinerama x11vnc option can be used to have it automatically + [404]-xinerama x11vnc option can be used to have it automatically determine the rectangles to be blackened out. (Note on 8bpp PseudoColor displays the fill color may not be black). Some users have reported that the mouse does not behave properly for their Xinerama display: i.e. the mouse cannot be moved to all regions - of the large display. If this happens try using the [401]-xwarppointer + of the large display. If this happens try using the [405]-xwarppointer option. This instructs x11vnc to fake mouse pointer motions using the XWarpPointer function instead of the XTestFakeMotionEvent XTEST function. (This may be due to a bug in the X server for XTEST when @@ -4020,23 +4044,23 @@ ied) Note: if you are running on Solaris 8 or earlier you can easily hit up against the maximum of 6 shm segments per process (for Xsun in this case) from running multiple x11vnc processes. You should modify - /etc/system as mentioned in another [402]FAQ to increase the limit. It - is probably also a good idea to run with the [403]-onetile option in + /etc/system as mentioned in another [406]FAQ to increase the limit. It + is probably also a good idea to run with the [407]-onetile option in this case (to limit each x11vnc to 3 shm segments), or even - [404]-noshm to use no shm segments. + [408]-noshm to use no shm segments. Q-74: Can x11vnc show only a portion of the display? (E.g. for a special purpose rfb application). - As of Mar/2005 in the libvncserver CVS x11vnc has the "[405]-clip + As of Mar/2005 in the libvncserver CVS x11vnc has the "[409]-clip WxH+X+Y" option to select a rectangle of width W, height H and offset (X, Y). Thus the VNC screen will be the clipped sub-region of the display and be only WxH in size. One user used -clip to split up a - large [406]Xinerama screen into two more managable smaller screens. + large [410]Xinerama screen into two more managable smaller screens. This also works to view a sub-region of a single application window if - the [407]-id or [408]-sid options are used. The offset is measured + the [411]-id or [412]-sid options are used. The offset is measured from the upper left corner of the selected window. @@ -4045,7 +4069,7 @@ ied) crash. As of Dec/2004 in the libvncserver CVS x11vnc supports XRANDR. You - enable it with the [409]-xrandr option to make x11vnc monitor XRANDR + enable it with the [413]-xrandr option to make x11vnc monitor XRANDR events and also trap X server errors if the screen change occurred in the middle of an X call like XGetImage. Once it traps the screen change it will create a new framebuffer using the new screen. @@ -4055,7 +4079,7 @@ ied) then the viewer will automatically resize. Otherwise, the new framebuffer is fit as best as possible into the original viewer size (portions of the screen may be clipped, unused, etc). For these - viewers you can try the [410]-padgeom option to make the region big + viewers you can try the [414]-padgeom option to make the region big enough to hold all resizes and rotations. If you specify "-xrandr newfbsize" then vnc viewers that do not @@ -4109,9 +4133,9 @@ ied) * Fullscreen mode The way VMWare does Fullscreen mode on Linux is to display the Guest - desktop in a separate Virtual Console (e.g. VC 8) (see [411]this FAQ + desktop in a separate Virtual Console (e.g. VC 8) (see [415]this FAQ on VC's for background). Unfortunately, this Fullscreen VC is not an X - server. So x11vnc cannot access it (however, [412]see this for a + server. So x11vnc cannot access it (however, [416]see this for a possible partial workaround). x11vnc works fine with "Normal X application window" and "Quick-Switch mode" because these use X. @@ -4128,13 +4152,13 @@ ied) response. One can also cut the display depth (e.g. to 16bpp) in this 2nd X session to improve video performance. This 2nd X session emulates Fullscreen mode to some degree and can be viewed via x11vnc - as long as the VMWare X session [413]is in the active VC. + as long as the VMWare X session [417]is in the active VC. Also note that with a little bit of playing with "xwininfo -all -children" output one can extract the (non-toplevel) windowid of the of the Guest desktop only when VMWare is running as a normal X application. Then one can export just the guest desktop (i.e. without - the VMWare menu buttons) by use of the [414]-id windowid option. The + the VMWare menu buttons) by use of the [418]-id windowid option. The caveats are the X session VMWare is in must be in the active VC and the window must be fully visible, so this mode is not terribly convenient, but could be useful in some circumstances (e.g. running @@ -4215,7 +4239,7 @@ ied) screen to either shm or a mapped file. The format of these is XWD and so the initial header should be skipped. BTW, since XWD is not strictly RGB the view will only be approximate. Of course for the case - of Xvfb x11vnc can poll it much better via the [415]X API, but you get + of Xvfb x11vnc can poll it much better via the [419]X API, but you get the idea. By default in -rawfb mode x11vnc will actually close any X display it @@ -4268,7 +4292,7 @@ ied) keystrokes into the Linux console (e.g. the virtual consoles: /dev/tty1, /dev/tty2, etc) in x11vnc/misc/vcinject.pl. It is based on the vncterm/LinuxVNC.c program also in the libvncserver CVS. So to - view and interact with VC #2 (assuming it is the [416]active VC) one + view and interact with VC #2 (assuming it is the [420]active VC) one can run something like: x11vnc -rawfb map:/dev/fb0@1024x768x16 -pipeinput './vcinject.pl 2' @@ -4281,7 +4305,7 @@ ied) more accurate and faster LinuxVNC program. The only advantage x11vnc -rawfb might have is that it can presumably allow interaction with a non-text application, e.g. one based on svgalib. For example the - [417]VMWare Fullscreen mode is actually viewable under -rawfb. But + [421]VMWare Fullscreen mode is actually viewable under -rawfb. But this isn't much use until one figures out how to inject keystrokes and mouse events... @@ -4313,10 +4337,10 @@ ied) As of Jan/2004 in the libvncserver CVS x11vnc supports the "CutText" part of the rfb protocol. Furthermore, x11vnc is able to hold the PRIMARY selection (Xvnc does not seem to do this). If you don't want - the Clipboard/Selection exchanged use the [418]-nosel option. If you + the Clipboard/Selection exchanged use the [422]-nosel option. If you don't want the PRIMARY selection to be polled for changes use the - [419]-noprimary option. You can also fine-tune it a bit with the - [420]-seldir dir option. + [423]-noprimary option. You can also fine-tune it a bit with the + [424]-seldir dir option. You may need to watch out for desktop utilities such as KDE's "Klipper" that do odd things with the selection, clipboard, and @@ -4331,7 +4355,7 @@ ied) not on by default in Solaris, see Xserver(1) for how to turn it on via +kb), and so you won't hear them if the extension is not present. - If you don't want to hear the beeps use the [421]-nobell option. If + If you don't want to hear the beeps use the [425]-nobell option. If you want to hear the audio from the remote applications, consider trying a redirector such as esd. @@ -4347,7 +4371,7 @@ ied) Click on the PayPal button below for more info. Also, in general I always enjoy hearing from x11vnc users, how they use it, what new features they would like, etc. Please send me an - [422]email! + [426]email! [PayPal] @@ -4554,227 +4578,231 @@ References 199. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-notruecolor 200. http://www.karlrunge.com/x11vnc/index.html#faq-8bpp 201. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 202. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 204. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 205. http://www.karlrunge.com/x11vnc/index.html#faq-overlays + 202. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 + 203. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 204. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 + 205. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen 206. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 207. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid - 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display - 209. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 210. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder - 211. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 212. http://www.karlrunge.com/x11vnc/index.html#xauth_pain - 213. http://www.karlrunge.com/x11vnc/index.html#faq-noshm - 214. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 216. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 217. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg - 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods - 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys - 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote - 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query - 222. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd - 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 225. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile - 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd - 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd - 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd - 229. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 230. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 231. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input - 232. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever - 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared - 234. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 235. http://www.karlrunge.com/x11vnc/index.html#faq-passwd - 236. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile - 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 238. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 239. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers - 240. http://www.karlrunge.com/x11vnc/index.html#faq-inetd - 241. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen - 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 243. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 244. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 245. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen - 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow - 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 249. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 250. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 251. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth - 253. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile - 254. http://www.karlrunge.com/x11vnc/index.html#gateway_double_ssh - 255. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 258. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly - 259. ftp://ftp.x.org/ - 260. http://www.karlrunge.com/x11vnc/dtVncPopup - 261. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 262. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost - 263. http://www.karlrunge.com/x11vnc/index.html#tunnelling - 264. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users - 266. http://www.karlrunge.com/x11vnc/blockdpy.c - 267. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept - 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone - 270. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept - 271. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously - 272. http://www.karlrunge.com/x11vnc/index.html#faq-inetd - 273. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop - 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 275. http://www.karlrunge.com/x11vnc/index.html#dtlogin_solaris - 276. http://www.jirka.org/gdm-documentation/x241.html - 277. http://www.karlrunge.com/x11vnc/x11vnc_loop - 278. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth - 279. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd - 280. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q - 281. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth - 282. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir - 283. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http - 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect - 286. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 287. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 288. http://www.karlrunge.com/x11vnc/Xdummy - 289. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously - 290. http://www.karlrunge.com/x11vnc/shm_clear - 291. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 292. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 293. http://www.karlrunge.com/x11vnc/index.html#faq-noshm - 294. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap - 295. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 297. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 300. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid - 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 304. http://www.tightvnc.com/ - 305. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 306. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 307. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 308. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs - 309. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait - 310. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer - 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive - 312. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 313. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 314. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 315. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 316. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-readtimeout - 317. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 318. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area - 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem - 320. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 207. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-8to24 + 208. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 209. http://www.karlrunge.com/x11vnc/index.html#faq-overlays + 210. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 211. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sid + 212. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-display + 213. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 214. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-flipbyteorder + 215. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 216. http://www.karlrunge.com/x11vnc/index.html#xauth_pain + 217. http://www.karlrunge.com/x11vnc/index.html#faq-noshm + 218. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 219. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 220. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 221. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-bg + 222. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_mods + 223. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clear_keys + 224. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remote + 225. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-query + 226. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 227. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd + 228. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 229. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile + 230. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-storepasswd + 231. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewpasswd + 232. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwd + 233. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 234. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 235. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-input + 236. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-forever + 237. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-shared + 238. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 239. http://www.karlrunge.com/x11vnc/index.html#faq-passwd + 240. http://www.karlrunge.com/x11vnc/index.html#faq-passwdfile + 241. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 242. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 243. http://www.karlrunge.com/x11vnc/index.html#faq-tcp_wrappers + 244. http://www.karlrunge.com/x11vnc/index.html#faq-inetd + 245. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen + 246. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 247. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 248. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 249. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 250. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-listen + 251. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-allow + 252. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 253. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 254. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 255. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 256. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbauth + 257. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-passwdfile + 258. http://www.karlrunge.com/x11vnc/index.html#gateway_double_ssh + 259. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 260. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 261. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 262. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-viewonly + 263. ftp://ftp.x.org/ + 264. http://www.karlrunge.com/x11vnc/dtVncPopup + 265. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 266. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-localhost + 267. http://www.karlrunge.com/x11vnc/index.html#tunnelling + 268. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 269. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-users + 270. http://www.karlrunge.com/x11vnc/blockdpy.c + 271. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-accept + 272. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 273. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gone + 274. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-afteraccept + 275. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously + 276. http://www.karlrunge.com/x11vnc/index.html#faq-inetd + 277. http://www.karlrunge.com/x11vnc/index.html#x11vnc_loop + 278. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 279. http://www.karlrunge.com/x11vnc/index.html#dtlogin_solaris + 280. http://www.jirka.org/gdm-documentation/x241.html + 281. http://www.karlrunge.com/x11vnc/x11vnc_loop + 282. http://www.karlrunge.com/x11vnc/index.html#faq-xterminal-xauth + 283. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-inetd + 284. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-q + 285. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-auth + 286. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-httpdir + 287. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-http + 288. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 289. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-vncconnect + 290. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 291. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 292. http://www.karlrunge.com/x11vnc/Xdummy + 293. http://www.karlrunge.com/x11vnc/index.html#display-manager-continuously + 294. http://www.karlrunge.com/x11vnc/shm_clear + 295. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 296. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 297. http://www.karlrunge.com/x11vnc/index.html#faq-noshm + 298. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nap + 299. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 300. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 301. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 302. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 303. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 304. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 305. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-solid + 306. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 307. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 308. http://www.tightvnc.com/ + 309. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 310. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 311. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 312. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fs + 313. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wait + 314. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-defer + 315. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-progressive + 316. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 317. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 318. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 319. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 320. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-readtimeout 321. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 322. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 323. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 324. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging - 325. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode - 326. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads - 327. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe - 328. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect - 329. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode - 330. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 331. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 332. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 333. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 322. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_area + 323. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xd_mem + 324. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noxdamage + 325. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 326. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 327. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 328. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nodragging + 329. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-pointer_mode + 330. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-threads + 331. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe + 332. http://www.karlrunge.com/x11vnc/index.html#faq-scrollcopyrect + 333. http://www.karlrunge.com/x11vnc/index.html#faq-pointer-mode 334. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow - 335. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 335. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe 336. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe - 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect - 338. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe - 339. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen - 340. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip - 341. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 342. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect - 343. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 344. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor - 345. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay - 346. http://www.karlrunge.com/x11vnc/index.html#the-overlay-mode - 347. http://www.karlrunge.com/x11vnc/index.html#solaris10-build - 348. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks - 349. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut - 350. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac - 351. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove - 352. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 353. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend - 354. http://www.tightvnc.com/ - 355. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor - 356. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos - 357. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos - 358. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape - 359. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 360. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer - 361. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap - 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 363. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless - 364. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak - 365. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard - 366. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 367. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys - 368. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 369. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 370. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 371. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak - 372. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard - 373. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless - 374. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 375. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys - 376. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak - 377. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 337. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 338. http://www.karlrunge.com/x11vnc/index.html#fb_read_slow + 339. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 340. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wireframe + 341. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-wirecopyrect + 342. http://www.karlrunge.com/x11vnc/index.html#faq-wireframe + 343. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-fixscreen + 344. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scr_skip + 345. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 346. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scrollcopyrect + 347. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 348. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursor + 349. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-overlay + 350. http://www.karlrunge.com/x11vnc/index.html#the-overlay-mode + 351. http://www.karlrunge.com/x11vnc/index.html#solaris10-build + 352. http://www.karlrunge.com/x11vnc/index.html#faq-xfixes-alpha-hacks + 353. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphacut + 354. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alphafrac + 355. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-alpharemove + 356. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 357. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noalphablend + 358. http://www.tightvnc.com/ + 359. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursor + 360. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-cursorpos + 361. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorpos + 362. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nocursorshape + 363. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap + 364. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_pointer + 365. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-buttonmap + 366. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 367. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless + 368. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak + 369. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 370. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 371. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 372. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 373. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 374. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 375. http://www.karlrunge.com/x11vnc/index.html#faq-xkbmodtweak + 376. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-debug_keyboard + 377. http://www.karlrunge.com/x11vnc/index.html#faq-greaterless 378. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb - 379. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes - 380. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 381. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 382. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 383. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 384. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms - 385. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 386. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat - 387. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager - 388. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 389. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 390. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 391. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap - 392. http://www.karlrunge.com/x11vnc/index.html#faq-scaling - 393. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale - 394. http://www.cus.cam.ac.uk/~ssb22/source/vnc-magnification.html - 395. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport - 396. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui - 397. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect - 398. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor - 399. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout - 400. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama - 401. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer - 402. http://www.karlrunge.com/x11vnc/index.html#faq-solshm - 403. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile - 404. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm - 405. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip - 406. http://www.karlrunge.com/x11vnc/index.html#faq-xinerama - 407. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 408. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 409. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr - 410. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom - 411. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 412. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb - 413. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 414. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id - 415. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb - 416. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc - 417. http://www.karlrunge.com/x11vnc/index.html#faq-vmware - 418. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel - 419. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary - 420. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-seldir - 421. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell - 422. mailto:xvml@karlrunge.com + 379. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-sloppy_keys + 380. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-modtweak + 381. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 382. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xkb + 383. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-skip_keycodes + 384. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 385. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 386. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 387. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 388. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-add_keysyms + 389. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 390. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-norepeat + 391. http://www.karlrunge.com/x11vnc/index.html#faq-display-manager + 392. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 393. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 394. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 395. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-remap + 396. http://www.karlrunge.com/x11vnc/index.html#faq-scaling + 397. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale + 398. http://www.cus.cam.ac.uk/~ssb22/source/vnc-magnification.html + 399. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-rfbport + 400. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-gui + 401. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-connect + 402. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-scale_cursor + 403. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-blackout + 404. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xinerama + 405. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xwarppointer + 406. http://www.karlrunge.com/x11vnc/index.html#faq-solshm + 407. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-onetile + 408. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noshm + 409. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-clip + 410. http://www.karlrunge.com/x11vnc/index.html#faq-xinerama + 411. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 412. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 413. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-xrandr + 414. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-padgeom + 415. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 416. http://www.karlrunge.com/x11vnc/index.html#faq-rawfb + 417. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 418. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-id + 419. http://www.karlrunge.com/x11vnc/index.html#faq-xvfb + 420. http://www.karlrunge.com/x11vnc/index.html#faq-linuxvc + 421. http://www.karlrunge.com/x11vnc/index.html#faq-vmware + 422. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nosel + 423. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-noprimary + 424. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-seldir + 425. http://www.karlrunge.com/x11vnc/x11vnc_opts.html#opt-nobell + 426. mailto:xvml@karlrunge.com ======================================================================= @@ -4787,7 +4815,7 @@ x11vnc: a VNC server for real X displays Here are all of x11vnc command line options: % x11vnc -opts (see below for -help long descriptions) -x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-11 +x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-14 x11vnc options: -display disp -auth file @@ -4795,77 +4823,78 @@ x11vnc options: -clip WxH+X+Y -flashcmap -shiftcmap n -notruecolor -visual n -overlay - -overlay_nocursor -scale fraction - -scale_cursor frac -viewonly - -shared -once - -forever -loop - -timeout n -inetd - -nofilexfer -http - -connect string -vncconnect - -novncconnect -allow host1[,host2..] - -localhost -nolookup - -input string -viewpasswd string - -passwdfile filename -nopw - -storepasswd pass file -accept string - -afteraccept string -gone string - -users list -noshm - -flipbyteorder -onetile - -solid [color] -blackout string - -xinerama -xtrap - -xrandr [mode] -padgeom WxH - -o logfile -flag file - -rc filename -norc - -h, -help -?, -opts - -V, -version -dbg - -q -bg - -modtweak -nomodtweak - -xkb -noxkb - -skip_keycodes string -sloppy_keys - -skip_dups -noskip_dups - -add_keysyms -noadd_keysyms - -clear_mods -clear_keys - -remap string -norepeat - -repeat -nofb - -nobell -nosel - -noprimary -seldir string - -cursor [mode] -nocursor - -arrow n -noxfixes - -alphacut n -alphafrac fraction - -alpharemove -noalphablend - -nocursorshape -cursorpos - -nocursorpos -xwarppointer - -buttonmap string -nodragging - -wireframe [str] -nowireframe - -wirecopyrect mode -nowirecopyrect - -debug_wireframe -scrollcopyrect mode - -noscrollcopyrect -scr_area n - -scr_skip list -scr_inc list - -scr_keys list -scr_term list - -scr_keyrepeat lo-hi -scr_parms string - -fixscreen string -debug_scroll - -noxrecord -grab_buster - -nograb_buster -debug_grabs - -pointer_mode n -input_skip n - -speeds rd,bw,lat -wmdt string - -debug_pointer -debug_keyboard - -defer time -wait time - -wait_ui factor -nowait_bog - -slow_fb time -readtimeout n - -nap -nonap - -sb time -noxdamage - -xd_area A -xd_mem f - -sigpipe string -threads - -nothreads -fs f - -gaps n -grow n - -fuzz n -debug_tiles - -snapfb -rawfb string - -pipeinput cmd -gui [gui-opts] - -remote command -query variable - -QD variable -sync - -noremote -yesremote - -unsafe -safer - -privremote -nocmds - -deny_all + -overlay_nocursor -8to24 + -scale fraction -scale_cursor frac + -viewonly -shared + -once -forever + -loop -timeout n + -inetd -nofilexfer + -http -connect string + -vncconnect -novncconnect + -allow host1[,host2..] -localhost + -nolookup -input string + -viewpasswd string -passwdfile filename + -nopw -storepasswd pass file + -accept string -afteraccept string + -gone string -users list + -noshm -flipbyteorder + -onetile -solid [color] + -blackout string -xinerama + -xtrap -xrandr [mode] + -padgeom WxH -o logfile + -flag file -rc filename + -norc -h, -help + -?, -opts -V, -version + -dbg -q + -bg -modtweak + -nomodtweak -xkb + -noxkb -skip_keycodes string + -sloppy_keys -skip_dups + -noskip_dups -add_keysyms + -noadd_keysyms -clear_mods + -clear_keys -remap string + -norepeat -repeat + -nofb -nobell + -nosel -noprimary + -seldir string -cursor [mode] + -nocursor -arrow n + -noxfixes -alphacut n + -alphafrac fraction -alpharemove + -noalphablend -nocursorshape + -cursorpos -nocursorpos + -xwarppointer -buttonmap string + -nodragging -wireframe [str] + -nowireframe -wirecopyrect mode + -nowirecopyrect -debug_wireframe + -scrollcopyrect mode -noscrollcopyrect + -scr_area n -scr_skip list + -scr_inc list -scr_keys list + -scr_term list -scr_keyrepeat lo-hi + -scr_parms string -fixscreen string + -debug_scroll -noxrecord + -grab_buster -nograb_buster + -debug_grabs -pointer_mode n + -input_skip n -speeds rd,bw,lat + -wmdt string -debug_pointer + -debug_keyboard -defer time + -wait time -wait_ui factor + -nowait_bog -slow_fb time + -readtimeout n -nap + -nonap -sb time + -noxdamage -xd_area A + -xd_mem f -sigpipe string + -threads -nothreads + -fs f -gaps n + -grow n -fuzz n + -debug_tiles -snapfb + -rawfb string -pipeinput cmd + -gui [gui-opts] -remote command + -query variable -QD variable + -sync -noremote + -yesremote -unsafe + -safer -privremote + -nocmds -deny_all + libvncserver options: -rfbport port TCP port for RFB protocol @@ -4897,7 +4926,7 @@ libvncserver-tight-extension options: % x11vnc -help -x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-11 +x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-14 Typical usage is: @@ -5027,6 +5056,38 @@ Options: -overlay_nocursor Sets -overlay, but does not try to draw the exact mouse cursor shape using the overlay mechanism. +-8to24 If -overlay is not supported on your OS, and you have a + legacy 8bpp app that you want to view on a multi-depth + display with default depth 24 (and is 32 bpp), try + this option. This option may not work on all X servers + and hardware (tested on XFree86/Xorg mga driver). + + It enables a hack where x11vnc monitors windows within 3 + levels from the root window. If it finds any that are + 8bpp it will apply a transformation for pixel data in + these regions where it extracts the 8bpp index color + value from bits 25-32 and maps them on to TrueColor + values and inserts them into bits 1-24 (i.e. overwrites + bits 1-24). This method appears to work, but may still + have bugs and note that it does hog resources. If there + are multiple 8bpp windows using different colormaps, + one may have to iconify all but one for the colors to + be correct. + + There may also be painting errors for clipping + and switching between windows of depths 8 and 24. + Heuristics are applied to try to minimize the painting + errors. One can also press 3 Alt_L's in a row to + refresh the screen if the error does not repair itself. + Also the option, say, -fixscreen V=3.0 may be use + to periodically refresh the screen (at the cost of + bandwidth). + + Note that -8to24 does not work on displays with 8bpp + default visual with depth 24 applications. The Xserver + -cc option can be used to switch the default depth on + multidepth setups. + -scale fraction Scale the framebuffer by factor "fraction". Values less than 1 shrink the fb, larger ones expand it. Note: image may not be sharp and response may be slower. @@ -6461,6 +6522,8 @@ n overlay_cursor in -overlay mode, enable cursor drawing. overlay_nocursor disable cursor drawing. same as nooverlay_cursor. + 8to24 enable -8to24 mode (if applicable). + no8to24 disable -8to24 mode. visual:vis set -visual to "vis" scale:frac set -scale to "frac" scale_cursor:f set -scale_cursor to "f" @@ -6714,10 +6777,10 @@ n nowaitmapped clip flashcmap noflashcmap shiftcmap truecolor notruecolor overlay nooverlay overlay_cursor overlay_yescursor nooverlay_nocursor nooverlay_cursor - nooverlay_yescursor overlay_nocursor visual scale - scale_cursor viewonly noviewonly shared noshared - forever noforever once timeout filexfer deny lock - nodeny unlock connect allowonce allow localhost + nooverlay_yescursor overlay_nocursor 8to24 no8to24 + visual scale scale_cursor viewonly noviewonly shared + noshared forever noforever once timeout filexfer deny + lock nodeny unlock connect allowonce allow localhost nolocalhost listen lookup nolookup accept afteraccept gone shm noshm flipbyteorder noflipbyteorder onetile noonetile solid_color solid nosolid blackout xinerama diff --git a/x11vnc/connections.c b/x11vnc/connections.c index b444208..800d443 100644 --- a/x11vnc/connections.c +++ b/x11vnc/connections.c @@ -1512,7 +1512,7 @@ void check_connect_inputs(void) { } void check_gui_inputs(void) { - int i, nmax = 0, n = 0, nfds; + int i, gnmax = 0, n = 0, nfds; int socks[ICON_MODE_SOCKS]; fd_set fds; struct timeval tv; @@ -1522,8 +1522,8 @@ void check_gui_inputs(void) { for (i=0; i= 0) { socks[n++] = i; - if (icon_mode_socks[i] > nmax) { - nmax = icon_mode_socks[i]; + if (icon_mode_socks[i] > gnmax) { + gnmax = icon_mode_socks[i]; } } } @@ -1539,7 +1539,7 @@ void check_gui_inputs(void) { tv.tv_sec = 0; tv.tv_usec = 0; - nfds = select(nmax+1, &fds, NULL, NULL, &tv); + nfds = select(gnmax+1, &fds, NULL, NULL, &tv); if (nfds <= 0) { return; } diff --git a/x11vnc/cursor.c b/x11vnc/cursor.c index a840cc7..ec50e28 100644 --- a/x11vnc/cursor.c +++ b/x11vnc/cursor.c @@ -1783,4 +1783,3 @@ int check_x11_pointer(void) { return set_cursor(x, y, get_which_cursor()); } - diff --git a/x11vnc/help.c b/x11vnc/help.c index 0d6ddd5..f68b92b 100644 --- a/x11vnc/help.c +++ b/x11vnc/help.c @@ -147,6 +147,38 @@ void print_help(int mode) { "-overlay_nocursor Sets -overlay, but does not try to draw the exact mouse\n" " cursor shape using the overlay mechanism.\n" "\n" +"-8to24 If -overlay is not supported on your OS, and you have a\n" +" legacy 8bpp app that you want to view on a multi-depth\n" +" display with default depth 24 (and is 32 bpp), try\n" +" this option. This option may not work on all X servers\n" +" and hardware (tested on XFree86/Xorg mga driver).\n" +"\n" +" It enables a hack where x11vnc monitors windows within 3\n" +" levels from the root window. If it finds any that are\n" +" 8bpp it will apply a transformation for pixel data in\n" +" these regions where it extracts the 8bpp index color\n" +" value from bits 25-32 and maps them on to TrueColor\n" +" values and inserts them into bits 1-24 (i.e. overwrites\n" +" bits 1-24). This method appears to work, but may still\n" +" have bugs and note that it does hog resources. If there\n" +" are multiple 8bpp windows using different colormaps,\n" +" one may have to iconify all but one for the colors to\n" +" be correct.\n" +"\n" +" There may also be painting errors for clipping\n" +" and switching between windows of depths 8 and 24.\n" +" Heuristics are applied to try to minimize the painting\n" +" errors. One can also press 3 Alt_L's in a row to\n" +" refresh the screen if the error does not repair itself.\n" +" Also the option, say, -fixscreen V=3.0 may be use\n" +" to periodically refresh the screen (at the cost of\n" +" bandwidth).\n" +"\n" +" Note that -8to24 does not work on displays with 8bpp\n" +" default visual with depth 24 applications. The Xserver\n" +" -cc option can be used to switch the default depth on\n" +" multidepth setups.\n" +"\n" "-scale fraction Scale the framebuffer by factor \"fraction\". Values\n" " less than 1 shrink the fb, larger ones expand it. Note:\n" " image may not be sharp and response may be slower.\n" @@ -1590,6 +1622,8 @@ void print_help(int mode) { " overlay_cursor in -overlay mode, enable cursor drawing.\n" " overlay_nocursor disable cursor drawing. same as\n" " nooverlay_cursor.\n" +" 8to24 enable -8to24 mode (if applicable).\n" +" no8to24 disable -8to24 mode.\n" " visual:vis set -visual to \"vis\"\n" " scale:frac set -scale to \"frac\"\n" " scale_cursor:f set -scale_cursor to \"f\"\n" @@ -1849,10 +1883,10 @@ void print_help(int mode) { " nowaitmapped clip flashcmap noflashcmap shiftcmap\n" " truecolor notruecolor overlay nooverlay overlay_cursor\n" " overlay_yescursor nooverlay_nocursor nooverlay_cursor\n" -" nooverlay_yescursor overlay_nocursor visual scale\n" -" scale_cursor viewonly noviewonly shared noshared\n" -" forever noforever once timeout filexfer deny lock\n" -" nodeny unlock connect allowonce allow localhost\n" +" nooverlay_yescursor overlay_nocursor 8to24 no8to24\n" +" visual scale scale_cursor viewonly noviewonly shared\n" +" noshared forever noforever once timeout filexfer deny\n" +" lock nodeny unlock connect allowonce allow localhost\n" " nolocalhost listen lookup nolookup accept afteraccept\n" " gone shm noshm flipbyteorder noflipbyteorder onetile\n" " noonetile solid_color solid nosolid blackout xinerama\n" diff --git a/x11vnc/options.c b/x11vnc/options.c index 6646aac..3d548e0 100644 --- a/x11vnc/options.c +++ b/x11vnc/options.c @@ -88,6 +88,7 @@ int first_conn_timeout = 0; /* -timeout */ int flash_cmap = 0; /* follow installed colormaps */ int shift_cmap = 0; /* ncells < 256 and needs shift of pixel values */ int force_indexed_color = 0; /* whether to force indexed color for 8bpp */ +int cmap8to24 = 0; /* -8to24 */ int launch_gui = 0; /* -gui */ int use_modifier_tweak = 1; /* use the shift/altgr modifier tweak */ diff --git a/x11vnc/options.h b/x11vnc/options.h index ae5ef43..b734f59 100644 --- a/x11vnc/options.h +++ b/x11vnc/options.h @@ -63,6 +63,7 @@ extern int first_conn_timeout; extern int flash_cmap; extern int shift_cmap; extern int force_indexed_color; +extern int cmap8to24; extern int launch_gui; extern int use_modifier_tweak; diff --git a/x11vnc/remote.c b/x11vnc/remote.c index 2a82ca8..64e915e 100644 --- a/x11vnc/remote.c +++ b/x11vnc/remote.c @@ -979,6 +979,24 @@ char *process_remote_cmd(char *cmd, int stringonly) { rfbLog(" -R cursor:... to re-enable any cursors.\n"); } + } else if (!strcmp(p, "8to24")) { + if (query) { + snprintf(buf, bufn, "ans=%s:%d", p, cmap8to24); + goto qry; + } + rfbLog("remote_cmd: turning on -8to24 mode.\n"); + cmap8to24 = 1; + do_new_fb(0); + + } else if (!strcmp(p, "no8to24")) { + if (query) { + snprintf(buf, bufn, "ans=%s:%d", p, !cmap8to24); + goto qry; + } + rfbLog("remote_cmd: turning off -8to24 mode.\n"); + cmap8to24 = 0; + do_new_fb(0); + } else if (strstr(p, "visual") == p) { COLON_CHECK("visual:") if (query) { diff --git a/x11vnc/scan.c b/x11vnc/scan.c index 45fbd3f..e956dc9 100644 --- a/x11vnc/scan.c +++ b/x11vnc/scan.c @@ -6,6 +6,7 @@ #include "xdamage.h" #include "xrandr.h" #include "win_utils.h" +#include "8to24.h" #include "screen.h" #include "pointer.h" #include "cleanup.h" @@ -1158,6 +1159,7 @@ void scale_rect(double factor, int blend, int interpolate, int Bpp, } void scale_and_mark_rect(int X1, int Y1, int X2, int Y2) { + char *src_fb = main_fb; if (!screen || !rfb_fb || !main_fb) { return; @@ -1181,8 +1183,12 @@ void scale_and_mark_rect(int X1, int Y1, int X2, int Y2) { } } + if (cmap8to24 && cmap8to24_fb) { + src_fb = cmap8to24_fb; + } + scale_rect(scale_fac, scaling_blend, scaling_interpolate, bpp/8, - main_fb, main_bytes_per_line, rfb_fb, rfb_bytes_per_line, + src_fb, main_bytes_per_line, rfb_fb, rfb_bytes_per_line, dpy_x, dpy_y, scaled_x, scaled_y, X1, Y1, X2, Y2, 1); } @@ -1212,8 +1218,17 @@ void mark_rect_as_modified(int x1, int y1, int x2, int y2, int force) { if (rfb_fb == main_fb || force) { rfbMarkRectAsModified(screen, x1, y1, x2, y2); - } else if (scaling) { + return; + } + + if (cmap8to24) { + bpp8to24(x1, y1, x2, y2); + } + + if (scaling) { scale_and_mark_rect(x1, y1, x2, y2); + } else { + rfbMarkRectAsModified(screen, x1, y1, x2, y2); } } @@ -2416,6 +2431,9 @@ int scan_for_updates(int count_only) { /* check for changed colormap */ set_colormap(0); } + if (cmap8to24 && scan_count % 4 == 0) { + check_for_multivis(); + } if (use_xdamage) { /* first pass collecting DAMAGE events: */ collect_xdamage(scan_count, 0); diff --git a/x11vnc/screen.c b/x11vnc/screen.c index ae81ec4..f6d61fc 100644 --- a/x11vnc/screen.c +++ b/x11vnc/screen.c @@ -544,8 +544,9 @@ static void nofb_hook(rfbClientPtr cl) { void do_new_fb(int reset_mem) { XImage *fb; - char *old_main = main_fb; - char *old_rfb = rfb_fb; + char *old_main = main_fb; + char *old_rfb = rfb_fb; + char *old_8to24 = cmap8to24_fb; /* for threaded we really should lock libvncserver out. */ if (use_threads) { @@ -569,12 +570,15 @@ void do_new_fb(int reset_mem) { initialize_polling_images(); } - if (old_main != old_rfb && old_main) { + if (old_main) { free(old_main); } - if (old_rfb) { + if (old_rfb && old_rfb != old_main) { free(old_rfb); } + if (old_8to24 && old_8to24 != old_main && old_8to24 != old_rfb) { + free(old_8to24); + } fb0 = fb; } @@ -1754,12 +1758,31 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { if (nofb) { main_fb = NULL; rfb_fb = main_fb; + cmap8to24_fb = NULL; screen->displayHook = nofb_hook; } else { main_fb = fb->data; + rfb_fb = NULL; + cmap8to24_fb = NULL; + + if (cmap8to24) { + if (screen->serverFormat.bitsPerPixel != 32 || + screen->serverFormat.depth != 24) { + if (!quiet) rfbLog("disabling -8to24 mode:" + " bpp != 32 or depth != 24\n"); + cmap8to24 = 0; + } + } + if (cmap8to24) { + int n = main_bytes_per_line * fb->height; + cmap8to24_fb = (char *) malloc(n); + memset(cmap8to24_fb, 0, n); + } if (scaling) { rfb_fb = (char *) malloc(rfb_bytes_per_line * height); memset(rfb_fb, 0, rfb_bytes_per_line * height); + } else if (cmap8to24) { + rfb_fb = cmap8to24_fb; } else { rfb_fb = main_fb; } @@ -1768,6 +1791,7 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { if (!quiet) { fprintf(stderr, " main_fb: %p\n", main_fb); fprintf(stderr, " rfb_fb: %p\n", rfb_fb); + fprintf(stderr, " 8to24_fb: %p\n", cmap8to24_fb); fprintf(stderr, "\n"); } @@ -1780,7 +1804,7 @@ void initialize_screen(int *argc, char **argv, XImage *fb) { setup_cursors_and_push(); - if (scaling) { + if (scaling || cmap8to24) { mark_rect_as_modified(0, 0, dpy_x, dpy_y, 0); } diff --git a/x11vnc/tkx11vnc b/x11vnc/tkx11vnc index aabfa0a..5429144 100755 --- a/x11vnc/tkx11vnc +++ b/x11vnc/tkx11vnc @@ -121,6 +121,7 @@ Screen =GAL OverlayVisuals:: overlay overlay_nocursor + 8to24 =GAL LOFF =GAL 8-Bit-Color:: flashcmap @@ -1446,7 +1447,7 @@ proc parse_help {} { if {! $sawopts} { continue; } - if {[regexp {^-([A-z_][A-z_]*)} $line match name]} { + if {[regexp {^-([0-9A-z_][0-9A-z_]*)} $line match name]} { set allnames($name) 1; if {"$curropt" != "no$name" && "no$curropt" != "$name"} { set curropt $name; @@ -1525,7 +1526,7 @@ proc parse_remote_help {} { if {! $sawopts} { continue; } - if {[regexp {^([A-z_][A-z_:]*)} $line match name]} { + if {[regexp {^([0-9A-z_][0-9A-z_:]*)} $line match name]} { regsub {:.*$} $name "" popt lappend possopts $popt if {"$curropt" != "no$name" && "no$curropt" != "$name"} { diff --git a/x11vnc/tkx11vnc.h b/x11vnc/tkx11vnc.h index c5aedf8..37d4c6b 100644 --- a/x11vnc/tkx11vnc.h +++ b/x11vnc/tkx11vnc.h @@ -132,6 +132,7 @@ char gui_code[] = ""; " =GAL OverlayVisuals::\n" " overlay\n" " overlay_nocursor\n" +" 8to24\n" " =GAL LOFF\n" " =GAL 8-Bit-Color::\n" " flashcmap\n" @@ -1457,7 +1458,7 @@ char gui_code[] = ""; " if {! $sawopts} {\n" " continue;\n" " }\n" -" if {[regexp {^-([A-z_][A-z_]*)} $line match name]} {\n" +" if {[regexp {^-([0-9A-z_][0-9A-z_]*)} $line match name]} {\n" " set allnames($name) 1;\n" " if {\"$curropt\" != \"no$name\" && \"no$curropt\" != \"$name\"} {\n" " set curropt $name;\n" @@ -1536,7 +1537,7 @@ char gui_code[] = ""; " if {! $sawopts} {\n" " continue;\n" " }\n" -" if {[regexp {^([A-z_][A-z_:]*)} $line match name]} {\n" +" if {[regexp {^([0-9A-z_][0-9A-z_:]*)} $line match name]} {\n" " regsub {:.*$} $name \"\" popt\n" " lappend possopts $popt\n" " if {\"$curropt\" != \"no$name\" && \"no$curropt\" != \"$name\"} {\n" diff --git a/x11vnc/userinput.c b/x11vnc/userinput.c index 062fea5..d72d5c7 100644 --- a/x11vnc/userinput.c +++ b/x11vnc/userinput.c @@ -14,6 +14,7 @@ #include "keyboard.h" #include "solid.h" #include "xrandr.h" +#include "8to24.h" /* * user input handling heuristics @@ -241,7 +242,7 @@ WIREFRAME_PARMS "0xff,2,0,30+6+6+6,Alt,0.05+0.3+2.0,8" shade,linewidth,percent,T+B+L+R,mods,t1+t2+t3+t4 */ #define LW_MAX 8 -static unsigned long wireframe_shade; +static unsigned long wireframe_shade = 0xff; static int wireframe_lw; static double wireframe_frac; static int wireframe_top, wireframe_bot, wireframe_left, wireframe_right; @@ -3694,6 +3695,25 @@ if (db) fprintf(stderr, "send_copyrect: %d\n", sent_copyrect); /* final push (for -nowirecopyrect) */ rfbPE(1000); wireframe_in_progress = 0; + + if (frame_changed && cmap8to24 && multivis_count) { + /* handle -8to24 tweak, mark area and check 8bpp... */ + int x1, x2, y1, y2, f = 16; + x1 = nmin(box_x, orig_x) - f; + y1 = nmin(box_y, orig_y) - f; + x2 = nmax(box_x + box_w, orig_x + orig_w) + f; + y2 = nmax(box_y + box_h, orig_y + orig_h) + f; + x1 = nfix(x1, dpy_x); + x2 = nfix(x2, dpy_x); + y1 = nfix(y1, dpy_y); + y2 = nfix(y2, dpy_y); +if (0) fprintf(stderr, "wireframe_in_progress over: %d %d %d %d\n", x1, y1, x2, y2); + check_for_multivis(); + if (1) mark_rect_as_modified(x1, y1, x2, y2, 0); + if (0) mark_rect_as_modified(0, 0, dpy_x, dpy_y, 0); + if (0) rfbPE(-1); + } + urgent_update = 1; if (use_xdamage) { /* DAMAGE can queue ~1000 rectangles for a move */ diff --git a/x11vnc/util.c b/x11vnc/util.c index 4d5dfe2..0d73ace 100644 --- a/x11vnc/util.c +++ b/x11vnc/util.c @@ -14,6 +14,8 @@ MUTEX(scrollMutex); #endif int nfix(int i, int n); +int nmin(int n, int m); +int nmax(int n, int m); int nabs(int n); double dabs(double x); void lowercase(char *str); @@ -42,6 +44,9 @@ double rfac(void); void rfbPE(long usec); void rfbCFD(long usec); +double rect_overlap(int x1, int y1, int x2, int y2, int X1, int Y1, + int X2, int Y2); + /* * routine to keep 0 <= i < n, should use in more places... @@ -55,6 +60,22 @@ int nfix(int i, int n) { return i; } +int nmin(int n, int m) { + if (n < m) { + return n; + } else { + return m; + } +} + +int nmax(int n, int m) { + if (n > m) { + return n; + } else { + return m; + } +} + int nabs(int n) { if (n < 0) { return -n; @@ -394,4 +415,39 @@ void rfbCFD(long usec) { } } +double rect_overlap(int x1, int y1, int x2, int y2, int X1, int Y1, + int X2, int Y2) { + double a, A, o; + sraRegionPtr r, R, overlap; + sraRectangleIterator *iter; + sraRect rt; + + a = nabs((x2 - x1) * (y2 - y1)); + A = nabs((X2 - X1) * (Y2 - Y1)); + + r = sraRgnCreateRect(x1, y1, x2, y2); + R = sraRgnCreateRect(X1, Y1, X2, Y2); + + overlap = sraRgnCreateRect(x1, y1, x2, y2); + + sraRgnAnd(overlap, R); + + o = 0.0; + iter = sraRgnGetIterator(overlap); + while (sraRgnIteratorNext(iter, &rt)) { + o += nabs( (rt.x2 - rt.x1) * (rt.y2 - rt.y1) ); + } + sraRgnReleaseIterator(iter); + + sraRgnDestroy(r); + sraRgnDestroy(R); + sraRgnDestroy(overlap); + + if (a < A) { + o = o/a; + } else { + o = o/A; + } + return o; +} diff --git a/x11vnc/util.h b/x11vnc/util.h index e919cf3..92e5e00 100644 --- a/x11vnc/util.h +++ b/x11vnc/util.h @@ -4,6 +4,8 @@ /* -- util.h -- */ extern int nfix(int i, int n); +extern int nmin(int n, int m); +extern int nmax(int n, int m); extern int nabs(int n); extern double dabs(double x); extern void lowercase(char *str); @@ -31,6 +33,8 @@ extern double rfac(void); extern void rfbPE(long usec); extern void rfbCFD(long usec); +extern double rect_overlap(int x1, int y1, int x2, int y2, int X1, int Y1, + int X2, int Y2); #define NONUL(x) ((x) ? (x) : "") diff --git a/x11vnc/x11vnc.1 b/x11vnc/x11vnc.1 index 82ba197..43086c6 100644 --- a/x11vnc/x11vnc.1 +++ b/x11vnc/x11vnc.1 @@ -2,7 +2,7 @@ .TH X11VNC "1" "January 2006" "x11vnc " "User Commands" .SH NAME x11vnc - allow VNC connections to real X11 displays - version: 0.8, lastmod: 2006-01-11 + version: 0.8, lastmod: 2006-01-14 .SH SYNOPSIS .B x11vnc [OPTION]... @@ -177,6 +177,40 @@ visual (e.g. some apps have \fB-use24\fR or \fB-visual\fR options). Sets \fB-overlay,\fR but does not try to draw the exact mouse cursor shape using the overlay mechanism. .PP +\fB-8to24\fR +.IP +If \fB-overlay\fR is not supported on your OS, and you have a +legacy 8bpp app that you want to view on a multi-depth +display with default depth 24 (and is 32 bpp), try +this option. This option may not work on all X servers +and hardware (tested on XFree86/Xorg mga driver). +.IP +It enables a hack where x11vnc monitors windows within 3 +levels from the root window. If it finds any that are +8bpp it will apply a transformation for pixel data in +these regions where it extracts the 8bpp index color +value from bits 25-32 and maps them on to TrueColor +values and inserts them into bits 1-24 (i.e. overwrites +bits 1-24). This method appears to work, but may still +have bugs and note that it does hog resources. If there +are multiple 8bpp windows using different colormaps, +one may have to iconify all but one for the colors to +be correct. +.IP +There may also be painting errors for clipping +and switching between windows of depths 8 and 24. +Heuristics are applied to try to minimize the painting +errors. One can also press 3 Alt_L's in a row to +refresh the screen if the error does not repair itself. +Also the option, say, \fB-fixscreen\fR V=3.0 may be use +to periodically refresh the screen (at the cost of +bandwidth). +.IP +Note that \fB-8to24\fR does not work on displays with 8bpp +default visual with depth 24 applications. The Xserver +\fB-cc\fR option can be used to switch the default depth on +multidepth setups. +.PP \fB-scale\fR \fIfraction\fR .IP Scale the framebuffer by factor \fIfraction\fR. Values @@ -1979,6 +2013,10 @@ overlay_cursor in \fB-overlay\fR mode, enable cursor drawing. overlay_nocursor disable cursor drawing. same as nooverlay_cursor. .IP +8to24 enable \fB-8to24\fR mode (if applicable). +.IP +no8to24 disable \fB-8to24\fR mode. +.IP visual:vis set \fB-visual\fR to "vis" .IP scale:frac set \fB-scale\fR to "frac" @@ -2417,10 +2455,10 @@ refresh reset close disconnect id sid waitmapped nowaitmapped clip flashcmap noflashcmap shiftcmap truecolor notruecolor overlay nooverlay overlay_cursor overlay_yescursor nooverlay_nocursor nooverlay_cursor -nooverlay_yescursor overlay_nocursor visual scale -scale_cursor viewonly noviewonly shared noshared -forever noforever once timeout filexfer deny lock -nodeny unlock connect allowonce allow localhost +nooverlay_yescursor overlay_nocursor 8to24 no8to24 +visual scale scale_cursor viewonly noviewonly shared +noshared forever noforever once timeout filexfer deny +lock nodeny unlock connect allowonce allow localhost nolocalhost listen lookup nolookup accept afteraccept gone shm noshm flipbyteorder noflipbyteorder onetile noonetile solid_color solid nosolid blackout xinerama diff --git a/x11vnc/x11vnc.c b/x11vnc/x11vnc.c index aba7808..d833aff 100644 --- a/x11vnc/x11vnc.c +++ b/x11vnc/x11vnc.c @@ -907,6 +907,7 @@ static void print_settings(int try_http, int bg, char *gui_str) { fprintf(stderr, " flashcmap: %d\n", flash_cmap); fprintf(stderr, " shiftcmap: %d\n", shift_cmap); fprintf(stderr, " force_idx: %d\n", force_indexed_color); + fprintf(stderr, " cmap8to24: %d\n", cmap8to24); fprintf(stderr, " visual: %s\n", visual_str ? visual_str : "null"); fprintf(stderr, " overlay: %d\n", overlay); @@ -1270,6 +1271,8 @@ int main(int argc, char* argv[]) { } else if (!strcmp(arg, "-overlay_yescursor")) { overlay = 1; overlay_cursor = 2; + } else if (!strcmp(arg, "-8to24")) { + cmap8to24 = 1; } else if (!strcmp(arg, "-visual")) { CHECK_ARGC visual_str = strdup(argv[++i]); diff --git a/x11vnc/x11vnc.h b/x11vnc/x11vnc.h index 9ad8325..fd46d09 100644 --- a/x11vnc/x11vnc.h +++ b/x11vnc/x11vnc.h @@ -315,6 +315,7 @@ extern char *main_fb; /* our copy of the X11 fb */ extern char *rfb_fb; /* same as main_fb unless transformation */ extern char *fake_fb; /* used under -padgeom */ extern char *snap_fb; /* used under -snapfb */ +extern char *cmap8to24_fb; /* used under -8to24 */ extern char *raw_fb; extern char *raw_fb_addr; extern int raw_fb_offset; diff --git a/x11vnc/x11vnc_defs.c b/x11vnc/x11vnc_defs.c index 13d6b85..d9c0488 100644 --- a/x11vnc/x11vnc_defs.c +++ b/x11vnc/x11vnc_defs.c @@ -15,7 +15,7 @@ int xtrap_base_event_type = 0; int xdamage_base_event_type = 0; /* date +'lastmod: %Y-%m-%d' */ -char lastmod[] = "0.8 lastmod: 2006-01-11"; +char lastmod[] = "0.8 lastmod: 2006-01-14"; /* X display info */ @@ -57,6 +57,7 @@ char *main_fb = NULL; /* our copy of the X11 fb */ char *rfb_fb = NULL; /* same as main_fb unless transformation */ char *fake_fb = NULL; /* used under -padgeom */ char *snap_fb = NULL; /* used under -snapfb */ +char *cmap8to24_fb = NULL; /* used under -8to24 */ char *raw_fb = NULL; char *raw_fb_addr = NULL; int raw_fb_offset = 0;