#undef I3__FILE__ #define I3__FILE__ "match.c" /* * vim:ts=4:sw=4:expandtab * * i3 - an improved dynamic tiling window manager * © 2009 Michael Stapelberg and contributors (see also: LICENSE) * * A "match" is a data structure which acts like a mask or expression to match * certain windows or not. For example, when using commands, you can specify a * command like this: [title="*Firefox*"] kill. The title member of the match * data structure will then be filled and i3 will check each window using * match_matches_window() to find the windows affected by this command. * */ #include "all.h" /* From sys/time.h, not sure if it’s available on all systems. */ #define _i3_timercmp(a, b, CMP) \ (((a).tv_sec == (b).tv_sec) ? ((a).tv_usec CMP(b).tv_usec) : ((a).tv_sec CMP(b).tv_sec)) /* * Initializes the Match data structure. This function is necessary because the * members representing boolean values (like dock) need to be initialized with * -1 instead of 0. * */ void match_init(Match *match) { memset(match, 0, sizeof(Match)); match->dock = M_DONTCHECK; match->urgent = U_DONTCHECK; /* we use this as the placeholder value for "not set". */ match->window_type = UINT32_MAX; } /* * Check if a match is empty. This is necessary while parsing commands to see * whether the user specified a match at all. * */ bool match_is_empty(Match *match) { /* we cannot simply use memcmp() because the structure is part of a * TAILQ and I don’t want to start with things like assuming that the * last member of a struct really is at the end in memory… */ return (match->title == NULL && match->mark == NULL && match->application == NULL && match->class == NULL && match->instance == NULL && match->window_role == NULL && match->workspace == NULL && match->urgent == U_DONTCHECK && match->id == XCB_NONE && match->window_type == UINT32_MAX && match->con_id == NULL && match->dock == -1 && match->floating == M_ANY); } /* * Copies the data of a match from src to dest. * */ void match_copy(Match *dest, Match *src) { memcpy(dest, src, sizeof(Match)); /* The DUPLICATE_REGEX macro creates a new regular expression from the * ->pattern of the old one. It therefore does use a little more memory then * with a refcounting system, but it’s easier this way. */ #define DUPLICATE_REGEX(field) \ do { \ if (src->field != NULL) \ dest->field = regex_new(src->field->pattern); \ } while (0) DUPLICATE_REGEX(title); DUPLICATE_REGEX(mark); DUPLICATE_REGEX(application); DUPLICATE_REGEX(class); DUPLICATE_REGEX(instance); DUPLICATE_REGEX(window_role); DUPLICATE_REGEX(workspace); } /* * Check if a match data structure matches the given window. * */ bool match_matches_window(Match *match, i3Window *window) { LOG("Checking window 0x%08x (class %s)\n", window->id, window->class_class); if (match->class != NULL) { if (window->class_class == NULL) return false; if (strcmp(match->class->pattern, "__focused__") == 0 && strcmp(window->class_class, focused->window->class_class) == 0) { LOG("window class matches focused window\n"); } else if (regex_matches(match->class, window->class_class)) { LOG("window class matches (%s)\n", window->class_class); } else { return false; } } if (match->instance != NULL) { if (window->class_instance == NULL) return false; if (strcmp(match->instance->pattern, "__focused__") == 0 && strcmp(window->class_instance, focused->window->class_instance) == 0) { LOG("window instance matches focused window\n"); } else if (regex_matches(match->instance, window->class_instance)) { LOG("window instance matches (%s)\n", window->class_instance); } else { return false; } } if (match->id != XCB_NONE) { if (window->id == match->id) { LOG("match made by window id (%d)\n", window->id); } else { LOG("window id does not match\n"); return false; } } if (match->title != NULL) { if (window->name == NULL) return false; const char *title = i3string_as_utf8(window->name); if (strcmp(match->title->pattern, "__focused__") == 0 && strcmp(title, i3string_as_utf8(focused->window->name)) == 0) { LOG("window title matches focused window\n"); } else if (regex_matches(match->title, title)) { LOG("title matches (%s)\n", title); } else { return false; } } if (match->window_role != NULL) { if (window->role == NULL) return false; if (strcmp(match->window_role->pattern, "__focused__") == 0 && strcmp(window->role, focused->window->role) == 0) { LOG("window role matches focused window\n"); } else if (regex_matches(match->window_role, window->role)) { LOG("window_role matches (%s)\n", window->role); } else { return false; } } if (match->window_type != UINT32_MAX) { if (window->window_type == match->window_type) { LOG("window_type matches (%i)\n", match->window_type); } else { return false; } } Con *con = NULL; if (match->urgent == U_LATEST) { /* if the window isn't urgent, no sense in searching */ if (window->urgent.tv_sec == 0) { return false; } /* if we find a window that is newer than this one, bail */ TAILQ_FOREACH(con, &all_cons, all_cons) { if ((con->window != NULL) && _i3_timercmp(con->window->urgent, window->urgent, > )) { return false; } } LOG("urgent matches latest\n"); } if (match->urgent == U_OLDEST) { /* if the window isn't urgent, no sense in searching */ if (window->urgent.tv_sec == 0) { return false; } /* if we find a window that is older than this one (and not 0), bail */ TAILQ_FOREACH(con, &all_cons, all_cons) { if ((con->window != NULL) && (con->window->urgent.tv_sec != 0) && _i3_timercmp(con->window->urgent, window->urgent, < )) { return false; } } LOG("urgent matches oldest\n"); } if (match->workspace != NULL) { if ((con = con_by_window_id(window->id)) == NULL) return false; Con *ws = con_get_workspace(con); if (ws == NULL) return false; if (strcmp(match->workspace->pattern, "__focused__") == 0 && strcmp(ws->name, con_get_workspace(focused)->name) == 0) { LOG("workspace matches focused workspace\n"); } else if (regex_matches(match->workspace, ws->name)) { LOG("workspace matches (%s)\n", ws->name); } else { return false; } } if (match->dock != M_DONTCHECK) { if ((window->dock == W_DOCK_TOP && match->dock == M_DOCK_TOP) || (window->dock == W_DOCK_BOTTOM && match->dock == M_DOCK_BOTTOM) || ((window->dock == W_DOCK_TOP || window->dock == W_DOCK_BOTTOM) && match->dock == M_DOCK_ANY) || (window->dock == W_NODOCK && match->dock == M_NODOCK)) { LOG("dock status matches\n"); } else { LOG("dock status does not match\n"); return false; } } /* We don’t check the mark because this function is not even called when * the mark would have matched - it is checked in cmdparse.y itself */ if (match->mark != NULL) { LOG("mark does not match\n"); return false; } return true; } /* * Frees the given match. It must not be used afterwards! * */ void match_free(Match *match) { regex_free(match->title); regex_free(match->application); regex_free(match->class); regex_free(match->instance); regex_free(match->mark); regex_free(match->window_role); regex_free(match->workspace); } /* * Interprets a ctype=cvalue pair and adds it to the given match specification. * */ void match_parse_property(Match *match, const char *ctype, const char *cvalue) { assert(match != NULL); DLOG("ctype=*%s*, cvalue=*%s*\n", ctype, cvalue); if (strcmp(ctype, "class") == 0) { regex_free(match->class); match->class = regex_new(cvalue); return; } if (strcmp(ctype, "instance") == 0) { regex_free(match->instance); match->instance = regex_new(cvalue); return; } if (strcmp(ctype, "window_role") == 0) { regex_free(match->window_role); match->window_role = regex_new(cvalue); return; } if (strcmp(ctype, "con_id") == 0) { if (strcmp(cvalue, "__focused__") == 0) { match->con_id = focused; return; } char *end; long parsed = strtol(cvalue, &end, 10); if (parsed == LONG_MIN || parsed == LONG_MAX || parsed < 0 || (end && *end != '\0')) { ELOG("Could not parse con id \"%s\"\n", cvalue); } else { match->con_id = (Con *)parsed; DLOG("id as int = %p\n", match->con_id); } return; } if (strcmp(ctype, "id") == 0) { char *end; long parsed = strtol(cvalue, &end, 10); if (parsed == LONG_MIN || parsed == LONG_MAX || parsed < 0 || (end && *end != '\0')) { ELOG("Could not parse window id \"%s\"\n", cvalue); } else { match->id = parsed; DLOG("window id as int = %d\n", match->id); } return; } if (strcmp(ctype, "window_type") == 0) { if (strcasecmp(cvalue, "normal") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_NORMAL; else if (strcasecmp(cvalue, "dialog") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_DIALOG; else if (strcasecmp(cvalue, "utility") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_UTILITY; else if (strcasecmp(cvalue, "toolbar") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_TOOLBAR; else if (strcasecmp(cvalue, "splash") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_SPLASH; else if (strcasecmp(cvalue, "menu") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_MENU; else if (strcasecmp(cvalue, "dropdown_menu") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_DROPDOWN_MENU; else if (strcasecmp(cvalue, "popup_menu") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_POPUP_MENU; else if (strcasecmp(cvalue, "tooltip") == 0) match->window_type = A__NET_WM_WINDOW_TYPE_TOOLTIP; else ELOG("unknown window_type value \"%s\"\n", cvalue); return; } if (strcmp(ctype, "con_mark") == 0) { regex_free(match->mark); match->mark = regex_new(cvalue); return; } if (strcmp(ctype, "title") == 0) { regex_free(match->title); match->title = regex_new(cvalue); return; } if (strcmp(ctype, "urgent") == 0) { if (strcasecmp(cvalue, "latest") == 0 || strcasecmp(cvalue, "newest") == 0 || strcasecmp(cvalue, "recent") == 0 || strcasecmp(cvalue, "last") == 0) { match->urgent = U_LATEST; } else if (strcasecmp(cvalue, "oldest") == 0 || strcasecmp(cvalue, "first") == 0) { match->urgent = U_OLDEST; } return; } if (strcmp(ctype, "workspace") == 0) { regex_free(match->workspace); match->workspace = regex_new(cvalue); return; } ELOG("Unknown criterion: %s\n", ctype); }