1 // SPDX-License-Identifier: GPL-2.0 2 #include <linux/fanotify.h> 3 #include <linux/fdtable.h> 4 #include <linux/fsnotify_backend.h> 5 #include <linux/init.h> 6 #include <linux/jiffies.h> 7 #include <linux/kernel.h> /* UINT_MAX */ 8 #include <linux/mount.h> 9 #include <linux/sched.h> 10 #include <linux/sched/user.h> 11 #include <linux/sched/signal.h> 12 #include <linux/types.h> 13 #include <linux/wait.h> 14 #include <linux/audit.h> 15 #include <linux/sched/mm.h> 16 #include <linux/statfs.h> 17 #include <linux/stringhash.h> 18 19 #include "fanotify.h" 20 21 static bool fanotify_path_equal(struct path *p1, struct path *p2) 22 { 23 return p1->mnt == p2->mnt && p1->dentry == p2->dentry; 24 } 25 26 static unsigned int fanotify_hash_path(const struct path *path) 27 { 28 return hash_ptr(path->dentry, FANOTIFY_EVENT_HASH_BITS) ^ 29 hash_ptr(path->mnt, FANOTIFY_EVENT_HASH_BITS); 30 } 31 32 static inline bool fanotify_fsid_equal(__kernel_fsid_t *fsid1, 33 __kernel_fsid_t *fsid2) 34 { 35 return fsid1->val[0] == fsid2->val[0] && fsid1->val[1] == fsid2->val[1]; 36 } 37 38 static unsigned int fanotify_hash_fsid(__kernel_fsid_t *fsid) 39 { 40 return hash_32(fsid->val[0], FANOTIFY_EVENT_HASH_BITS) ^ 41 hash_32(fsid->val[1], FANOTIFY_EVENT_HASH_BITS); 42 } 43 44 static bool fanotify_fh_equal(struct fanotify_fh *fh1, 45 struct fanotify_fh *fh2) 46 { 47 if (fh1->type != fh2->type || fh1->len != fh2->len) 48 return false; 49 50 return !fh1->len || 51 !memcmp(fanotify_fh_buf(fh1), fanotify_fh_buf(fh2), fh1->len); 52 } 53 54 static unsigned int fanotify_hash_fh(struct fanotify_fh *fh) 55 { 56 long salt = (long)fh->type | (long)fh->len << 8; 57 58 /* 59 * full_name_hash() works long by long, so it handles fh buf optimally. 60 */ 61 return full_name_hash((void *)salt, fanotify_fh_buf(fh), fh->len); 62 } 63 64 static bool fanotify_fid_event_equal(struct fanotify_fid_event *ffe1, 65 struct fanotify_fid_event *ffe2) 66 { 67 /* Do not merge fid events without object fh */ 68 if (!ffe1->object_fh.len) 69 return false; 70 71 return fanotify_fsid_equal(&ffe1->fsid, &ffe2->fsid) && 72 fanotify_fh_equal(&ffe1->object_fh, &ffe2->object_fh); 73 } 74 75 static bool fanotify_info_equal(struct fanotify_info *info1, 76 struct fanotify_info *info2) 77 { 78 if (info1->dir_fh_totlen != info2->dir_fh_totlen || 79 info1->dir2_fh_totlen != info2->dir2_fh_totlen || 80 info1->file_fh_totlen != info2->file_fh_totlen || 81 info1->name_len != info2->name_len || 82 info1->name2_len != info2->name2_len) 83 return false; 84 85 if (info1->dir_fh_totlen && 86 !fanotify_fh_equal(fanotify_info_dir_fh(info1), 87 fanotify_info_dir_fh(info2))) 88 return false; 89 90 if (info1->dir2_fh_totlen && 91 !fanotify_fh_equal(fanotify_info_dir2_fh(info1), 92 fanotify_info_dir2_fh(info2))) 93 return false; 94 95 if (info1->file_fh_totlen && 96 !fanotify_fh_equal(fanotify_info_file_fh(info1), 97 fanotify_info_file_fh(info2))) 98 return false; 99 100 if (info1->name_len && 101 memcmp(fanotify_info_name(info1), fanotify_info_name(info2), 102 info1->name_len)) 103 return false; 104 105 return !info1->name2_len || 106 !memcmp(fanotify_info_name2(info1), fanotify_info_name2(info2), 107 info1->name2_len); 108 } 109 110 static bool fanotify_name_event_equal(struct fanotify_name_event *fne1, 111 struct fanotify_name_event *fne2) 112 { 113 struct fanotify_info *info1 = &fne1->info; 114 struct fanotify_info *info2 = &fne2->info; 115 116 /* Do not merge name events without dir fh */ 117 if (!info1->dir_fh_totlen) 118 return false; 119 120 if (!fanotify_fsid_equal(&fne1->fsid, &fne2->fsid)) 121 return false; 122 123 return fanotify_info_equal(info1, info2); 124 } 125 126 static bool fanotify_error_event_equal(struct fanotify_error_event *fee1, 127 struct fanotify_error_event *fee2) 128 { 129 /* Error events against the same file system are always merged. */ 130 if (!fanotify_fsid_equal(&fee1->fsid, &fee2->fsid)) 131 return false; 132 133 return true; 134 } 135 136 static bool fanotify_should_merge(struct fanotify_event *old, 137 struct fanotify_event *new) 138 { 139 pr_debug("%s: old=%p new=%p\n", __func__, old, new); 140 141 if (old->hash != new->hash || 142 old->type != new->type || old->pid != new->pid) 143 return false; 144 145 /* 146 * We want to merge many dirent events in the same dir (i.e. 147 * creates/unlinks/renames), but we do not want to merge dirent 148 * events referring to subdirs with dirent events referring to 149 * non subdirs, otherwise, user won't be able to tell from a 150 * mask FAN_CREATE|FAN_DELETE|FAN_ONDIR if it describes mkdir+ 151 * unlink pair or rmdir+create pair of events. 152 */ 153 if ((old->mask & FS_ISDIR) != (new->mask & FS_ISDIR)) 154 return false; 155 156 /* 157 * FAN_RENAME event is reported with special info record types, 158 * so we cannot merge it with other events. 159 */ 160 if ((old->mask & FAN_RENAME) != (new->mask & FAN_RENAME)) 161 return false; 162 163 switch (old->type) { 164 case FANOTIFY_EVENT_TYPE_PATH: 165 return fanotify_path_equal(fanotify_event_path(old), 166 fanotify_event_path(new)); 167 case FANOTIFY_EVENT_TYPE_FID: 168 return fanotify_fid_event_equal(FANOTIFY_FE(old), 169 FANOTIFY_FE(new)); 170 case FANOTIFY_EVENT_TYPE_FID_NAME: 171 return fanotify_name_event_equal(FANOTIFY_NE(old), 172 FANOTIFY_NE(new)); 173 case FANOTIFY_EVENT_TYPE_FS_ERROR: 174 return fanotify_error_event_equal(FANOTIFY_EE(old), 175 FANOTIFY_EE(new)); 176 default: 177 WARN_ON_ONCE(1); 178 } 179 180 return false; 181 } 182 183 /* Limit event merges to limit CPU overhead per event */ 184 #define FANOTIFY_MAX_MERGE_EVENTS 128 185 186 /* and the list better be locked by something too! */ 187 static int fanotify_merge(struct fsnotify_group *group, 188 struct fsnotify_event *event) 189 { 190 struct fanotify_event *old, *new = FANOTIFY_E(event); 191 unsigned int bucket = fanotify_event_hash_bucket(group, new); 192 struct hlist_head *hlist = &group->fanotify_data.merge_hash[bucket]; 193 int i = 0; 194 195 pr_debug("%s: group=%p event=%p bucket=%u\n", __func__, 196 group, event, bucket); 197 198 /* 199 * Don't merge a permission event with any other event so that we know 200 * the event structure we have created in fanotify_handle_event() is the 201 * one we should check for permission response. 202 */ 203 if (fanotify_is_perm_event(new->mask)) 204 return 0; 205 206 hlist_for_each_entry(old, hlist, merge_list) { 207 if (++i > FANOTIFY_MAX_MERGE_EVENTS) 208 break; 209 if (fanotify_should_merge(old, new)) { 210 old->mask |= new->mask; 211 212 if (fanotify_is_error_event(old->mask)) 213 FANOTIFY_EE(old)->err_count++; 214 215 return 1; 216 } 217 } 218 219 return 0; 220 } 221 222 /* 223 * Wait for response to permission event. The function also takes care of 224 * freeing the permission event (or offloads that in case the wait is canceled 225 * by a signal). The function returns 0 in case access got allowed by userspace, 226 * -EPERM in case userspace disallowed the access, and -ERESTARTSYS in case 227 * the wait got interrupted by a signal. 228 */ 229 static int fanotify_get_response(struct fsnotify_group *group, 230 struct fanotify_perm_event *event, 231 struct fsnotify_iter_info *iter_info) 232 { 233 int ret; 234 235 pr_debug("%s: group=%p event=%p\n", __func__, group, event); 236 237 ret = wait_event_killable(group->fanotify_data.access_waitq, 238 event->state == FAN_EVENT_ANSWERED); 239 /* Signal pending? */ 240 if (ret < 0) { 241 spin_lock(&group->notification_lock); 242 /* Event reported to userspace and no answer yet? */ 243 if (event->state == FAN_EVENT_REPORTED) { 244 /* Event will get freed once userspace answers to it */ 245 event->state = FAN_EVENT_CANCELED; 246 spin_unlock(&group->notification_lock); 247 return ret; 248 } 249 /* Event not yet reported? Just remove it. */ 250 if (event->state == FAN_EVENT_INIT) { 251 fsnotify_remove_queued_event(group, &event->fae.fse); 252 /* Permission events are not supposed to be hashed */ 253 WARN_ON_ONCE(!hlist_unhashed(&event->fae.merge_list)); 254 } 255 /* 256 * Event may be also answered in case signal delivery raced 257 * with wakeup. In that case we have nothing to do besides 258 * freeing the event and reporting error. 259 */ 260 spin_unlock(&group->notification_lock); 261 goto out; 262 } 263 264 /* userspace responded, convert to something usable */ 265 switch (event->response & ~FAN_AUDIT) { 266 case FAN_ALLOW: 267 ret = 0; 268 break; 269 case FAN_DENY: 270 default: 271 ret = -EPERM; 272 } 273 274 /* Check if the response should be audited */ 275 if (event->response & FAN_AUDIT) 276 audit_fanotify(event->response & ~FAN_AUDIT); 277 278 pr_debug("%s: group=%p event=%p about to return ret=%d\n", __func__, 279 group, event, ret); 280 out: 281 fsnotify_destroy_event(group, &event->fae.fse); 282 283 return ret; 284 } 285 286 /* 287 * This function returns a mask for an event that only contains the flags 288 * that have been specifically requested by the user. Flags that may have 289 * been included within the event mask, but have not been explicitly 290 * requested by the user, will not be present in the returned mask. 291 */ 292 static u32 fanotify_group_event_mask(struct fsnotify_group *group, 293 struct fsnotify_iter_info *iter_info, 294 u32 *match_mask, u32 event_mask, 295 const void *data, int data_type, 296 struct inode *dir) 297 { 298 __u32 marks_mask = 0, marks_ignored_mask = 0; 299 __u32 test_mask, user_mask = FANOTIFY_OUTGOING_EVENTS | 300 FANOTIFY_EVENT_FLAGS; 301 const struct path *path = fsnotify_data_path(data, data_type); 302 unsigned int fid_mode = FAN_GROUP_FLAG(group, FANOTIFY_FID_BITS); 303 struct fsnotify_mark *mark; 304 int type; 305 306 pr_debug("%s: report_mask=%x mask=%x data=%p data_type=%d\n", 307 __func__, iter_info->report_mask, event_mask, data, data_type); 308 309 if (!fid_mode) { 310 /* Do we have path to open a file descriptor? */ 311 if (!path) 312 return 0; 313 /* Path type events are only relevant for files and dirs */ 314 if (!d_is_reg(path->dentry) && !d_can_lookup(path->dentry)) 315 return 0; 316 } else if (!(fid_mode & FAN_REPORT_FID)) { 317 /* Do we have a directory inode to report? */ 318 if (!dir && !(event_mask & FS_ISDIR)) 319 return 0; 320 } 321 322 fsnotify_foreach_iter_type(type) { 323 if (!fsnotify_iter_should_report_type(iter_info, type)) 324 continue; 325 mark = iter_info->marks[type]; 326 327 /* Apply ignore mask regardless of ISDIR and ON_CHILD flags */ 328 marks_ignored_mask |= mark->ignored_mask; 329 330 /* 331 * If the event is on dir and this mark doesn't care about 332 * events on dir, don't send it! 333 */ 334 if (event_mask & FS_ISDIR && !(mark->mask & FS_ISDIR)) 335 continue; 336 337 /* 338 * If the event is on a child and this mark is on a parent not 339 * watching children, don't send it! 340 */ 341 if (type == FSNOTIFY_ITER_TYPE_PARENT && 342 !(mark->mask & FS_EVENT_ON_CHILD)) 343 continue; 344 345 marks_mask |= mark->mask; 346 347 /* Record the mark types of this group that matched the event */ 348 *match_mask |= 1U << type; 349 } 350 351 test_mask = event_mask & marks_mask & ~marks_ignored_mask; 352 353 /* 354 * For dirent modification events (create/delete/move) that do not carry 355 * the child entry name information, we report FAN_ONDIR for mkdir/rmdir 356 * so user can differentiate them from creat/unlink. 357 * 358 * For backward compatibility and consistency, do not report FAN_ONDIR 359 * to user in legacy fanotify mode (reporting fd) and report FAN_ONDIR 360 * to user in fid mode for all event types. 361 * 362 * We never report FAN_EVENT_ON_CHILD to user, but we do pass it in to 363 * fanotify_alloc_event() when group is reporting fid as indication 364 * that event happened on child. 365 */ 366 if (fid_mode) { 367 /* Do not report event flags without any event */ 368 if (!(test_mask & ~FANOTIFY_EVENT_FLAGS)) 369 return 0; 370 } else { 371 user_mask &= ~FANOTIFY_EVENT_FLAGS; 372 } 373 374 return test_mask & user_mask; 375 } 376 377 /* 378 * Check size needed to encode fanotify_fh. 379 * 380 * Return size of encoded fh without fanotify_fh header. 381 * Return 0 on failure to encode. 382 */ 383 static int fanotify_encode_fh_len(struct inode *inode) 384 { 385 int dwords = 0; 386 int fh_len; 387 388 if (!inode) 389 return 0; 390 391 exportfs_encode_inode_fh(inode, NULL, &dwords, NULL); 392 fh_len = dwords << 2; 393 394 /* 395 * struct fanotify_error_event might be preallocated and is 396 * limited to MAX_HANDLE_SZ. This should never happen, but 397 * safeguard by forcing an invalid file handle. 398 */ 399 if (WARN_ON_ONCE(fh_len > MAX_HANDLE_SZ)) 400 return 0; 401 402 return fh_len; 403 } 404 405 /* 406 * Encode fanotify_fh. 407 * 408 * Return total size of encoded fh including fanotify_fh header. 409 * Return 0 on failure to encode. 410 */ 411 static int fanotify_encode_fh(struct fanotify_fh *fh, struct inode *inode, 412 unsigned int fh_len, unsigned int *hash, 413 gfp_t gfp) 414 { 415 int dwords, type = 0; 416 char *ext_buf = NULL; 417 void *buf = fh->buf; 418 int err; 419 420 fh->type = FILEID_ROOT; 421 fh->len = 0; 422 fh->flags = 0; 423 424 /* 425 * Invalid FHs are used by FAN_FS_ERROR for errors not 426 * linked to any inode. The f_handle won't be reported 427 * back to userspace. 428 */ 429 if (!inode) 430 goto out; 431 432 /* 433 * !gpf means preallocated variable size fh, but fh_len could 434 * be zero in that case if encoding fh len failed. 435 */ 436 err = -ENOENT; 437 if (fh_len < 4 || WARN_ON_ONCE(fh_len % 4) || fh_len > MAX_HANDLE_SZ) 438 goto out_err; 439 440 /* No external buffer in a variable size allocated fh */ 441 if (gfp && fh_len > FANOTIFY_INLINE_FH_LEN) { 442 /* Treat failure to allocate fh as failure to encode fh */ 443 err = -ENOMEM; 444 ext_buf = kmalloc(fh_len, gfp); 445 if (!ext_buf) 446 goto out_err; 447 448 *fanotify_fh_ext_buf_ptr(fh) = ext_buf; 449 buf = ext_buf; 450 fh->flags |= FANOTIFY_FH_FLAG_EXT_BUF; 451 } 452 453 dwords = fh_len >> 2; 454 type = exportfs_encode_inode_fh(inode, buf, &dwords, NULL); 455 err = -EINVAL; 456 if (!type || type == FILEID_INVALID || fh_len != dwords << 2) 457 goto out_err; 458 459 fh->type = type; 460 fh->len = fh_len; 461 462 out: 463 /* 464 * Mix fh into event merge key. Hash might be NULL in case of 465 * unhashed FID events (i.e. FAN_FS_ERROR). 466 */ 467 if (hash) 468 *hash ^= fanotify_hash_fh(fh); 469 470 return FANOTIFY_FH_HDR_LEN + fh_len; 471 472 out_err: 473 pr_warn_ratelimited("fanotify: failed to encode fid (type=%d, len=%d, err=%i)\n", 474 type, fh_len, err); 475 kfree(ext_buf); 476 *fanotify_fh_ext_buf_ptr(fh) = NULL; 477 /* Report the event without a file identifier on encode error */ 478 fh->type = FILEID_INVALID; 479 fh->len = 0; 480 return 0; 481 } 482 483 /* 484 * FAN_REPORT_FID is ambiguous in that it reports the fid of the child for 485 * some events and the fid of the parent for create/delete/move events. 486 * 487 * With the FAN_REPORT_TARGET_FID flag, the fid of the child is reported 488 * also in create/delete/move events in addition to the fid of the parent 489 * and the name of the child. 490 */ 491 static inline bool fanotify_report_child_fid(unsigned int fid_mode, u32 mask) 492 { 493 if (mask & ALL_FSNOTIFY_DIRENT_EVENTS) 494 return (fid_mode & FAN_REPORT_TARGET_FID); 495 496 return (fid_mode & FAN_REPORT_FID) && !(mask & FAN_ONDIR); 497 } 498 499 /* 500 * The inode to use as identifier when reporting fid depends on the event 501 * and the group flags. 502 * 503 * With the group flag FAN_REPORT_TARGET_FID, always report the child fid. 504 * 505 * Without the group flag FAN_REPORT_TARGET_FID, report the modified directory 506 * fid on dirent events and the child fid otherwise. 507 * 508 * For example: 509 * FS_ATTRIB reports the child fid even if reported on a watched parent. 510 * FS_CREATE reports the modified dir fid without FAN_REPORT_TARGET_FID. 511 * and reports the created child fid with FAN_REPORT_TARGET_FID. 512 */ 513 static struct inode *fanotify_fid_inode(u32 event_mask, const void *data, 514 int data_type, struct inode *dir, 515 unsigned int fid_mode) 516 { 517 if ((event_mask & ALL_FSNOTIFY_DIRENT_EVENTS) && 518 !(fid_mode & FAN_REPORT_TARGET_FID)) 519 return dir; 520 521 return fsnotify_data_inode(data, data_type); 522 } 523 524 /* 525 * The inode to use as identifier when reporting dir fid depends on the event. 526 * Report the modified directory inode on dirent modification events. 527 * Report the "victim" inode if "victim" is a directory. 528 * Report the parent inode if "victim" is not a directory and event is 529 * reported to parent. 530 * Otherwise, do not report dir fid. 531 */ 532 static struct inode *fanotify_dfid_inode(u32 event_mask, const void *data, 533 int data_type, struct inode *dir) 534 { 535 struct inode *inode = fsnotify_data_inode(data, data_type); 536 537 if (event_mask & ALL_FSNOTIFY_DIRENT_EVENTS) 538 return dir; 539 540 if (inode && S_ISDIR(inode->i_mode)) 541 return inode; 542 543 return dir; 544 } 545 546 static struct fanotify_event *fanotify_alloc_path_event(const struct path *path, 547 unsigned int *hash, 548 gfp_t gfp) 549 { 550 struct fanotify_path_event *pevent; 551 552 pevent = kmem_cache_alloc(fanotify_path_event_cachep, gfp); 553 if (!pevent) 554 return NULL; 555 556 pevent->fae.type = FANOTIFY_EVENT_TYPE_PATH; 557 pevent->path = *path; 558 *hash ^= fanotify_hash_path(path); 559 path_get(path); 560 561 return &pevent->fae; 562 } 563 564 static struct fanotify_event *fanotify_alloc_perm_event(const struct path *path, 565 gfp_t gfp) 566 { 567 struct fanotify_perm_event *pevent; 568 569 pevent = kmem_cache_alloc(fanotify_perm_event_cachep, gfp); 570 if (!pevent) 571 return NULL; 572 573 pevent->fae.type = FANOTIFY_EVENT_TYPE_PATH_PERM; 574 pevent->response = 0; 575 pevent->state = FAN_EVENT_INIT; 576 pevent->path = *path; 577 path_get(path); 578 579 return &pevent->fae; 580 } 581 582 static struct fanotify_event *fanotify_alloc_fid_event(struct inode *id, 583 __kernel_fsid_t *fsid, 584 unsigned int *hash, 585 gfp_t gfp) 586 { 587 struct fanotify_fid_event *ffe; 588 589 ffe = kmem_cache_alloc(fanotify_fid_event_cachep, gfp); 590 if (!ffe) 591 return NULL; 592 593 ffe->fae.type = FANOTIFY_EVENT_TYPE_FID; 594 ffe->fsid = *fsid; 595 *hash ^= fanotify_hash_fsid(fsid); 596 fanotify_encode_fh(&ffe->object_fh, id, fanotify_encode_fh_len(id), 597 hash, gfp); 598 599 return &ffe->fae; 600 } 601 602 static struct fanotify_event *fanotify_alloc_name_event(struct inode *dir, 603 __kernel_fsid_t *fsid, 604 const struct qstr *name, 605 struct inode *child, 606 struct dentry *moved, 607 unsigned int *hash, 608 gfp_t gfp) 609 { 610 struct fanotify_name_event *fne; 611 struct fanotify_info *info; 612 struct fanotify_fh *dfh, *ffh; 613 struct inode *dir2 = moved ? d_inode(moved->d_parent) : NULL; 614 const struct qstr *name2 = moved ? &moved->d_name : NULL; 615 unsigned int dir_fh_len = fanotify_encode_fh_len(dir); 616 unsigned int dir2_fh_len = fanotify_encode_fh_len(dir2); 617 unsigned int child_fh_len = fanotify_encode_fh_len(child); 618 unsigned long name_len = name ? name->len : 0; 619 unsigned long name2_len = name2 ? name2->len : 0; 620 unsigned int len, size; 621 622 /* Reserve terminating null byte even for empty name */ 623 size = sizeof(*fne) + name_len + name2_len + 2; 624 if (dir_fh_len) 625 size += FANOTIFY_FH_HDR_LEN + dir_fh_len; 626 if (dir2_fh_len) 627 size += FANOTIFY_FH_HDR_LEN + dir2_fh_len; 628 if (child_fh_len) 629 size += FANOTIFY_FH_HDR_LEN + child_fh_len; 630 fne = kmalloc(size, gfp); 631 if (!fne) 632 return NULL; 633 634 fne->fae.type = FANOTIFY_EVENT_TYPE_FID_NAME; 635 fne->fsid = *fsid; 636 *hash ^= fanotify_hash_fsid(fsid); 637 info = &fne->info; 638 fanotify_info_init(info); 639 if (dir_fh_len) { 640 dfh = fanotify_info_dir_fh(info); 641 len = fanotify_encode_fh(dfh, dir, dir_fh_len, hash, 0); 642 fanotify_info_set_dir_fh(info, len); 643 } 644 if (dir2_fh_len) { 645 dfh = fanotify_info_dir2_fh(info); 646 len = fanotify_encode_fh(dfh, dir2, dir2_fh_len, hash, 0); 647 fanotify_info_set_dir2_fh(info, len); 648 } 649 if (child_fh_len) { 650 ffh = fanotify_info_file_fh(info); 651 len = fanotify_encode_fh(ffh, child, child_fh_len, hash, 0); 652 fanotify_info_set_file_fh(info, len); 653 } 654 if (name_len) { 655 fanotify_info_copy_name(info, name); 656 *hash ^= full_name_hash((void *)name_len, name->name, name_len); 657 } 658 if (name2_len) { 659 fanotify_info_copy_name2(info, name2); 660 *hash ^= full_name_hash((void *)name2_len, name2->name, 661 name2_len); 662 } 663 664 pr_debug("%s: size=%u dir_fh_len=%u child_fh_len=%u name_len=%u name='%.*s'\n", 665 __func__, size, dir_fh_len, child_fh_len, 666 info->name_len, info->name_len, fanotify_info_name(info)); 667 668 if (dir2_fh_len) { 669 pr_debug("%s: dir2_fh_len=%u name2_len=%u name2='%.*s'\n", 670 __func__, dir2_fh_len, info->name2_len, 671 info->name2_len, fanotify_info_name2(info)); 672 } 673 674 return &fne->fae; 675 } 676 677 static struct fanotify_event *fanotify_alloc_error_event( 678 struct fsnotify_group *group, 679 __kernel_fsid_t *fsid, 680 const void *data, int data_type, 681 unsigned int *hash) 682 { 683 struct fs_error_report *report = 684 fsnotify_data_error_report(data, data_type); 685 struct inode *inode; 686 struct fanotify_error_event *fee; 687 int fh_len; 688 689 if (WARN_ON_ONCE(!report)) 690 return NULL; 691 692 fee = mempool_alloc(&group->fanotify_data.error_events_pool, GFP_NOFS); 693 if (!fee) 694 return NULL; 695 696 fee->fae.type = FANOTIFY_EVENT_TYPE_FS_ERROR; 697 fee->error = report->error; 698 fee->err_count = 1; 699 fee->fsid = *fsid; 700 701 inode = report->inode; 702 fh_len = fanotify_encode_fh_len(inode); 703 704 /* Bad fh_len. Fallback to using an invalid fh. Should never happen. */ 705 if (!fh_len && inode) 706 inode = NULL; 707 708 fanotify_encode_fh(&fee->object_fh, inode, fh_len, NULL, 0); 709 710 *hash ^= fanotify_hash_fsid(fsid); 711 712 return &fee->fae; 713 } 714 715 static struct fanotify_event *fanotify_alloc_event( 716 struct fsnotify_group *group, 717 u32 mask, const void *data, int data_type, 718 struct inode *dir, const struct qstr *file_name, 719 __kernel_fsid_t *fsid, u32 match_mask) 720 { 721 struct fanotify_event *event = NULL; 722 gfp_t gfp = GFP_KERNEL_ACCOUNT; 723 unsigned int fid_mode = FAN_GROUP_FLAG(group, FANOTIFY_FID_BITS); 724 struct inode *id = fanotify_fid_inode(mask, data, data_type, dir, 725 fid_mode); 726 struct inode *dirid = fanotify_dfid_inode(mask, data, data_type, dir); 727 const struct path *path = fsnotify_data_path(data, data_type); 728 struct mem_cgroup *old_memcg; 729 struct dentry *moved = NULL; 730 struct inode *child = NULL; 731 bool name_event = false; 732 unsigned int hash = 0; 733 bool ondir = mask & FAN_ONDIR; 734 struct pid *pid; 735 736 if ((fid_mode & FAN_REPORT_DIR_FID) && dirid) { 737 /* 738 * For certain events and group flags, report the child fid 739 * in addition to reporting the parent fid and maybe child name. 740 */ 741 if (fanotify_report_child_fid(fid_mode, mask) && id != dirid) 742 child = id; 743 744 id = dirid; 745 746 /* 747 * We record file name only in a group with FAN_REPORT_NAME 748 * and when we have a directory inode to report. 749 * 750 * For directory entry modification event, we record the fid of 751 * the directory and the name of the modified entry. 752 * 753 * For event on non-directory that is reported to parent, we 754 * record the fid of the parent and the name of the child. 755 * 756 * Even if not reporting name, we need a variable length 757 * fanotify_name_event if reporting both parent and child fids. 758 */ 759 if (!(fid_mode & FAN_REPORT_NAME)) { 760 name_event = !!child; 761 file_name = NULL; 762 } else if ((mask & ALL_FSNOTIFY_DIRENT_EVENTS) || !ondir) { 763 name_event = true; 764 } 765 766 /* 767 * In the special case of FAN_RENAME event, use the match_mask 768 * to determine if we need to report only the old parent+name, 769 * only the new parent+name or both. 770 * 'dirid' and 'file_name' are the old parent+name and 771 * 'moved' has the new parent+name. 772 */ 773 if (mask & FAN_RENAME) { 774 bool report_old, report_new; 775 776 if (WARN_ON_ONCE(!match_mask)) 777 return NULL; 778 779 /* Report both old and new parent+name if sb watching */ 780 report_old = report_new = 781 match_mask & (1U << FSNOTIFY_ITER_TYPE_SB); 782 report_old |= 783 match_mask & (1U << FSNOTIFY_ITER_TYPE_INODE); 784 report_new |= 785 match_mask & (1U << FSNOTIFY_ITER_TYPE_INODE2); 786 787 if (!report_old) { 788 /* Do not report old parent+name */ 789 dirid = NULL; 790 file_name = NULL; 791 } 792 if (report_new) { 793 /* Report new parent+name */ 794 moved = fsnotify_data_dentry(data, data_type); 795 } 796 } 797 } 798 799 /* 800 * For queues with unlimited length lost events are not expected and 801 * can possibly have security implications. Avoid losing events when 802 * memory is short. For the limited size queues, avoid OOM killer in the 803 * target monitoring memcg as it may have security repercussion. 804 */ 805 if (group->max_events == UINT_MAX) 806 gfp |= __GFP_NOFAIL; 807 else 808 gfp |= __GFP_RETRY_MAYFAIL; 809 810 /* Whoever is interested in the event, pays for the allocation. */ 811 old_memcg = set_active_memcg(group->memcg); 812 813 if (fanotify_is_perm_event(mask)) { 814 event = fanotify_alloc_perm_event(path, gfp); 815 } else if (fanotify_is_error_event(mask)) { 816 event = fanotify_alloc_error_event(group, fsid, data, 817 data_type, &hash); 818 } else if (name_event && (file_name || moved || child)) { 819 event = fanotify_alloc_name_event(dirid, fsid, file_name, child, 820 moved, &hash, gfp); 821 } else if (fid_mode) { 822 event = fanotify_alloc_fid_event(id, fsid, &hash, gfp); 823 } else { 824 event = fanotify_alloc_path_event(path, &hash, gfp); 825 } 826 827 if (!event) 828 goto out; 829 830 if (FAN_GROUP_FLAG(group, FAN_REPORT_TID)) 831 pid = get_pid(task_pid(current)); 832 else 833 pid = get_pid(task_tgid(current)); 834 835 /* Mix event info, FAN_ONDIR flag and pid into event merge key */ 836 hash ^= hash_long((unsigned long)pid | ondir, FANOTIFY_EVENT_HASH_BITS); 837 fanotify_init_event(event, hash, mask); 838 event->pid = pid; 839 840 out: 841 set_active_memcg(old_memcg); 842 return event; 843 } 844 845 /* 846 * Get cached fsid of the filesystem containing the object from any connector. 847 * All connectors are supposed to have the same fsid, but we do not verify that 848 * here. 849 */ 850 static __kernel_fsid_t fanotify_get_fsid(struct fsnotify_iter_info *iter_info) 851 { 852 int type; 853 __kernel_fsid_t fsid = {}; 854 855 fsnotify_foreach_iter_type(type) { 856 struct fsnotify_mark_connector *conn; 857 858 if (!fsnotify_iter_should_report_type(iter_info, type)) 859 continue; 860 861 conn = READ_ONCE(iter_info->marks[type]->connector); 862 /* Mark is just getting destroyed or created? */ 863 if (!conn) 864 continue; 865 if (!(conn->flags & FSNOTIFY_CONN_FLAG_HAS_FSID)) 866 continue; 867 /* Pairs with smp_wmb() in fsnotify_add_mark_list() */ 868 smp_rmb(); 869 fsid = conn->fsid; 870 if (WARN_ON_ONCE(!fsid.val[0] && !fsid.val[1])) 871 continue; 872 return fsid; 873 } 874 875 return fsid; 876 } 877 878 /* 879 * Add an event to hash table for faster merge. 880 */ 881 static void fanotify_insert_event(struct fsnotify_group *group, 882 struct fsnotify_event *fsn_event) 883 { 884 struct fanotify_event *event = FANOTIFY_E(fsn_event); 885 unsigned int bucket = fanotify_event_hash_bucket(group, event); 886 struct hlist_head *hlist = &group->fanotify_data.merge_hash[bucket]; 887 888 assert_spin_locked(&group->notification_lock); 889 890 if (!fanotify_is_hashed_event(event->mask)) 891 return; 892 893 pr_debug("%s: group=%p event=%p bucket=%u\n", __func__, 894 group, event, bucket); 895 896 hlist_add_head(&event->merge_list, hlist); 897 } 898 899 static int fanotify_handle_event(struct fsnotify_group *group, u32 mask, 900 const void *data, int data_type, 901 struct inode *dir, 902 const struct qstr *file_name, u32 cookie, 903 struct fsnotify_iter_info *iter_info) 904 { 905 int ret = 0; 906 struct fanotify_event *event; 907 struct fsnotify_event *fsn_event; 908 __kernel_fsid_t fsid = {}; 909 u32 match_mask = 0; 910 911 BUILD_BUG_ON(FAN_ACCESS != FS_ACCESS); 912 BUILD_BUG_ON(FAN_MODIFY != FS_MODIFY); 913 BUILD_BUG_ON(FAN_ATTRIB != FS_ATTRIB); 914 BUILD_BUG_ON(FAN_CLOSE_NOWRITE != FS_CLOSE_NOWRITE); 915 BUILD_BUG_ON(FAN_CLOSE_WRITE != FS_CLOSE_WRITE); 916 BUILD_BUG_ON(FAN_OPEN != FS_OPEN); 917 BUILD_BUG_ON(FAN_MOVED_TO != FS_MOVED_TO); 918 BUILD_BUG_ON(FAN_MOVED_FROM != FS_MOVED_FROM); 919 BUILD_BUG_ON(FAN_CREATE != FS_CREATE); 920 BUILD_BUG_ON(FAN_DELETE != FS_DELETE); 921 BUILD_BUG_ON(FAN_DELETE_SELF != FS_DELETE_SELF); 922 BUILD_BUG_ON(FAN_MOVE_SELF != FS_MOVE_SELF); 923 BUILD_BUG_ON(FAN_EVENT_ON_CHILD != FS_EVENT_ON_CHILD); 924 BUILD_BUG_ON(FAN_Q_OVERFLOW != FS_Q_OVERFLOW); 925 BUILD_BUG_ON(FAN_OPEN_PERM != FS_OPEN_PERM); 926 BUILD_BUG_ON(FAN_ACCESS_PERM != FS_ACCESS_PERM); 927 BUILD_BUG_ON(FAN_ONDIR != FS_ISDIR); 928 BUILD_BUG_ON(FAN_OPEN_EXEC != FS_OPEN_EXEC); 929 BUILD_BUG_ON(FAN_OPEN_EXEC_PERM != FS_OPEN_EXEC_PERM); 930 BUILD_BUG_ON(FAN_FS_ERROR != FS_ERROR); 931 BUILD_BUG_ON(FAN_RENAME != FS_RENAME); 932 933 BUILD_BUG_ON(HWEIGHT32(ALL_FANOTIFY_EVENT_BITS) != 21); 934 935 mask = fanotify_group_event_mask(group, iter_info, &match_mask, 936 mask, data, data_type, dir); 937 if (!mask) 938 return 0; 939 940 pr_debug("%s: group=%p mask=%x report_mask=%x\n", __func__, 941 group, mask, match_mask); 942 943 if (fanotify_is_perm_event(mask)) { 944 /* 945 * fsnotify_prepare_user_wait() fails if we race with mark 946 * deletion. Just let the operation pass in that case. 947 */ 948 if (!fsnotify_prepare_user_wait(iter_info)) 949 return 0; 950 } 951 952 if (FAN_GROUP_FLAG(group, FANOTIFY_FID_BITS)) { 953 fsid = fanotify_get_fsid(iter_info); 954 /* Racing with mark destruction or creation? */ 955 if (!fsid.val[0] && !fsid.val[1]) 956 return 0; 957 } 958 959 event = fanotify_alloc_event(group, mask, data, data_type, dir, 960 file_name, &fsid, match_mask); 961 ret = -ENOMEM; 962 if (unlikely(!event)) { 963 /* 964 * We don't queue overflow events for permission events as 965 * there the access is denied and so no event is in fact lost. 966 */ 967 if (!fanotify_is_perm_event(mask)) 968 fsnotify_queue_overflow(group); 969 goto finish; 970 } 971 972 fsn_event = &event->fse; 973 ret = fsnotify_insert_event(group, fsn_event, fanotify_merge, 974 fanotify_insert_event); 975 if (ret) { 976 /* Permission events shouldn't be merged */ 977 BUG_ON(ret == 1 && mask & FANOTIFY_PERM_EVENTS); 978 /* Our event wasn't used in the end. Free it. */ 979 fsnotify_destroy_event(group, fsn_event); 980 981 ret = 0; 982 } else if (fanotify_is_perm_event(mask)) { 983 ret = fanotify_get_response(group, FANOTIFY_PERM(event), 984 iter_info); 985 } 986 finish: 987 if (fanotify_is_perm_event(mask)) 988 fsnotify_finish_user_wait(iter_info); 989 990 return ret; 991 } 992 993 static void fanotify_free_group_priv(struct fsnotify_group *group) 994 { 995 kfree(group->fanotify_data.merge_hash); 996 if (group->fanotify_data.ucounts) 997 dec_ucount(group->fanotify_data.ucounts, 998 UCOUNT_FANOTIFY_GROUPS); 999 1000 if (mempool_initialized(&group->fanotify_data.error_events_pool)) 1001 mempool_exit(&group->fanotify_data.error_events_pool); 1002 } 1003 1004 static void fanotify_free_path_event(struct fanotify_event *event) 1005 { 1006 path_put(fanotify_event_path(event)); 1007 kmem_cache_free(fanotify_path_event_cachep, FANOTIFY_PE(event)); 1008 } 1009 1010 static void fanotify_free_perm_event(struct fanotify_event *event) 1011 { 1012 path_put(fanotify_event_path(event)); 1013 kmem_cache_free(fanotify_perm_event_cachep, FANOTIFY_PERM(event)); 1014 } 1015 1016 static void fanotify_free_fid_event(struct fanotify_event *event) 1017 { 1018 struct fanotify_fid_event *ffe = FANOTIFY_FE(event); 1019 1020 if (fanotify_fh_has_ext_buf(&ffe->object_fh)) 1021 kfree(fanotify_fh_ext_buf(&ffe->object_fh)); 1022 kmem_cache_free(fanotify_fid_event_cachep, ffe); 1023 } 1024 1025 static void fanotify_free_name_event(struct fanotify_event *event) 1026 { 1027 kfree(FANOTIFY_NE(event)); 1028 } 1029 1030 static void fanotify_free_error_event(struct fsnotify_group *group, 1031 struct fanotify_event *event) 1032 { 1033 struct fanotify_error_event *fee = FANOTIFY_EE(event); 1034 1035 mempool_free(fee, &group->fanotify_data.error_events_pool); 1036 } 1037 1038 static void fanotify_free_event(struct fsnotify_group *group, 1039 struct fsnotify_event *fsn_event) 1040 { 1041 struct fanotify_event *event; 1042 1043 event = FANOTIFY_E(fsn_event); 1044 put_pid(event->pid); 1045 switch (event->type) { 1046 case FANOTIFY_EVENT_TYPE_PATH: 1047 fanotify_free_path_event(event); 1048 break; 1049 case FANOTIFY_EVENT_TYPE_PATH_PERM: 1050 fanotify_free_perm_event(event); 1051 break; 1052 case FANOTIFY_EVENT_TYPE_FID: 1053 fanotify_free_fid_event(event); 1054 break; 1055 case FANOTIFY_EVENT_TYPE_FID_NAME: 1056 fanotify_free_name_event(event); 1057 break; 1058 case FANOTIFY_EVENT_TYPE_OVERFLOW: 1059 kfree(event); 1060 break; 1061 case FANOTIFY_EVENT_TYPE_FS_ERROR: 1062 fanotify_free_error_event(group, event); 1063 break; 1064 default: 1065 WARN_ON_ONCE(1); 1066 } 1067 } 1068 1069 static void fanotify_freeing_mark(struct fsnotify_mark *mark, 1070 struct fsnotify_group *group) 1071 { 1072 if (!FAN_GROUP_FLAG(group, FAN_UNLIMITED_MARKS)) 1073 dec_ucount(group->fanotify_data.ucounts, UCOUNT_FANOTIFY_MARKS); 1074 } 1075 1076 static void fanotify_free_mark(struct fsnotify_mark *fsn_mark) 1077 { 1078 kmem_cache_free(fanotify_mark_cache, fsn_mark); 1079 } 1080 1081 const struct fsnotify_ops fanotify_fsnotify_ops = { 1082 .handle_event = fanotify_handle_event, 1083 .free_group_priv = fanotify_free_group_priv, 1084 .free_event = fanotify_free_event, 1085 .freeing_mark = fanotify_freeing_mark, 1086 .free_mark = fanotify_free_mark, 1087 }; 1088