testcases/audit-test/docs/syscalls.txt

   1 # This file contains a description of the test cases used to verify
   2 # auditing of security relevant syscalls.  The information was pulled
   3 # from the comment headers in each of the syscall test cases.
   4
   5 FILE:
   6 test_access.c
   7
   8 PURPOSE:
   9 Verify audit of attempts to check file access permissions.
  10
  11 SYSCALLS:
  12 access()
  13
  14 TESTCASE: successful
  15 Check read access permissions on a file with read permissions.
  16
  17 TESTCASE: unsuccessful
  18 Attempt to check write access permissions on a file with read-only
  19 permissions.
  20
  21  ---
  22
  23 FILE:
  24 test_adjtimex.c
  25
  26 PURPOSE:
  27 Verify audit of attempts to tune kernel clock.
  28
  29 SYSCALLS:
  30 adjtimex()
  31
  32 TESTCASE: successful
  33 Noop as root user.
  34
  35 TESTCASE: unsuccessful
  36 Attempt to set timex mode as test user.
  37
  38  ---
  39
  40 FILE:
  41 test_bind.c
  42
  43 PURPOSE:
  44 Verify audit of attempts to bind a name to a socket.
  45
  46 SYSCALLS:
  47 bind()
  48
  49 TESTCASE: successful
  50 Bind to a privileged port as the super user.
  51
  52 TESTCASE: unsuccessful
  53 Attempt to bind to a privileged port as a non-privileged user.
  54
  55  ---
  56
  57 FILE:
  58 test_capset.c
  59
  60 PURPOSE:
  61 Verify audit of attempts to set process capabilities.
  62
  63 SYSCALLS:
  64 capset()
  65
  66 TESTCASE: successful
  67 Set capabilities as obtained from capget().
  68
  69 TESTCASE: unsuccessful
  70 Attempt to set a capability in the effective set that is not in
  71 the permitted set.
  72
  73  ---
  74
  75 FILE:
  76 test_chdir.c
  77
  78 PURPOSE:
  79 Verify audit of attempts to change working directory.
  80
  81 SYSCALLS:
  82 chdir()
  83
  84 TESTCASE: successful
  85 Change working directory to one for which user has access
  86 permissions.
  87
  88 TESTCASE: unsuccessful
  89 Attempt to change working directory to one for which user does not
  90 have access permissions.
  91
  92  ---
  93
  94 FILE:
  95 test_chmod.c
  96
  97 PURPOSE:
  98 Verify audit of attempts to change file access permissions.
  99
 100 SYSCALLS:
 101 chmod()
 102
 103 TESTCASE: successful
 104 Modify file access permissions for a file for which user has
 105 appropriate permissions to do so.
 106
 107 TESTCASE: unsuccessful
 108 Attempt to modify file access permissions for a file for which
 109 user does not have appropriate permissions to do so.
 110
 111  ---
 112
 113 FILE:
 114 test_chown.c
 115
 116 PURPOSE:
 117 Verify audit of attempts to change file owner and group.
 118
 119 SYSCALLS:
 120 chown(), chown32()
 121
 122 TESTCASE: successful
 123 Change a file's owner and group as the superuser.
 124
 125 TESTCASE: unsuccessful
 126 Attempt to change a file's owner and group as regular user.
 127
 128  ---
 129
 130 FILE:
 131 test_clock_settime.c
 132
 133 PURPOSE:
 134 Verify audit of attempts to change system time.
 135
 136 SYSCALLS:
 137 clock_settime()
 138
 139 TESTCASE: successful
 140 Set system time as root user.
 141
 142 TESTCASE: unsuccessful
 143 Attempt to set system time as test user.
 144
 145  ---
 146
 147 FILE:
 148 test_clone.c
 149
 150 PURPOSE:
 151 Verify audit of attempts to create child processes.
 152
 153 SYSCALLS:
 154 clone(), clone2
 155
 156 TESTCASE: successful
 157 Create a child process with CLONE_NEWNS as root user.
 158
 159 TESTCASE: unsuccessful
 160 Attempt to create a child process with CLONE_NEWNS as test user.
 161
 162  ---
 163
 164 FILE:
 165 test_creat.c
 166
 167 PURPOSE:
 168 Verify audit of attempts to create files.
 169
 170 SYSCALLS:
 171 creat()
 172
 173 TESTCASE: successful
 174 Create a file in a directory for which user has appropriate
 175 permissions.
 176
 177 TESTCASE: unsuccessful
 178 Attempt to create a file in a directory for which user does not
 179 have appropriate permissions.
 180
 181  ---
 182
 183 FILE:
 184 test_delete_module.c
 185
 186 PURPOSE:
 187 Verify audit of attempts to delete kernel module entries.
 188 SYSCALLS:
 189 delete_module()
 190
 191 TESTCASE: successful
 192 Delete module entry as root user.
 193
 194 TESTCASE: unsuccessful
 195 Attempt to delete module entry as test user.
 196
 197  ---
 198
 199 FILE:
 200 test_execve.c
 201
 202 PURPOSE:
 203 Verify audit of attempts to execute a program.
 204
 205 SYSCALLS:
 206 execve()
 207
 208 TESTCASE: successful
 209 Execute /bin/true.
 210
 211 TESTCASE: unsuccessful
 212 Attempt to execute a file which does have execute access
 213 permission.
 214
 215  ---
 216
 217 FILE:
 218 test_fchmod.c
 219
 220 PURPOSE:
 221 Verify audit of attempts to change file access permissions.
 222
 223 SYSCALLS:
 224 fchmod()
 225
 226 TESTCASE: successful
 227 Modify file access permissions for a file for which user has
 228 appropriate permissions to do so.
 229
 230 TESTCASE: unsuccessful
 231 Attempt to modify file access permissions for a file for which
 232 user does not have appropriate permissions to do so.
 233
 234  ---
 235
 236 FILE:
 237 test_fchown.c
 238
 239 PURPOSE:
 240 Verify audit of attempts to change file owner and group.
 241
 242 SYSCALLS:
 243 fchown(), fchown32()
 244
 245 TESTCASE: successful
 246 Change a file's owner and group as the superuser.
 247
 248 TESTCASE: unsuccessful
 249 Attempt to change a file's owner and group as regular user.
 250
 251  ---
 252
 253 FILE:
 254 test_fork.c
 255
 256 PURPOSE:
 257 Verify audit of attempts to create a child process.
 258
 259 SYSCALLS:
 260 fork(), vfork()
 261
 262 TESTCASE: successful
 263 Create a child process as root user.
 264
 265 TESTCASE: unsuccessful
 266 With RLIMIT_NPROC set to 1, attempt to create a child process as
 267 the test user.
 268
 269  ---
 270
 271 FILE:
 272 test_fremovexattr.c
 273
 274 PURPOSE:
 275 Verify audit of attempts to remove extended attributes via a file
 276 descriptor.
 277
 278 SYSCALLS:
 279 fremovexattr()
 280
 281 TESTCASE: successful
 282 Remove an extended attribute for a file for which user has
 283 appropriate permissions.
 284
 285 TESTCASE: unsuccessful
 286 Attempt to remove an extended attribute for a file for which
 287 user does not have appropriate permissions.
 288
 289  ---
 290
 291 FILE:
 292 test_fsetxattr.c
 293
 294 PURPOSE:
 295 Verify audit of attempts to set extended attribute values via a
 296 file descriptor.
 297
 298 SYSCALLS:
 299 fsetxattr()
 300
 301 TESTCASE: successful
 302 Set an extended attribute value for a file for which user has
 303 appropriate permissions.
 304
 305 TESTCASE: unsuccessful
 306 Attempt to set an extended attribute value for a file for which
 307 user does not have appropriate permissions.
 308
 309  ---
 310
 311 FILE:
 312 test_init_module.c
 313
 314 PURPOSE:
 315 Verify audit of attempts to initialize loadable kernel modules.
 316 SYSCALLS:
 317 init_module()
 318
 319 TESTCASE: successful
 320 Load kernel module as root user.
 321
 322 TESTCASE: unsuccessful
 323 Attempt to load kernel module as test user.
 324
 325  ---
 326
 327 FILE:
 328 test_ioctl.c
 329
 330 PURPOSE:
 331 Verify audit of device control operations.
 332
 333 SYSCALLS:
 334 ioctl()
 335
 336 TESTCASE: successful
 337 Get tty attributes of DEFAULT_DEVICE_FILE.
 338
 339 TESTCASE: unsuccessful
 340 Attempt to get tty attributes for invalid descriptor.
 341
 342  ---
 343
 344 FILE:
 345 test_ioperm.c
 346
 347 PURPOSE:
 348 Verify audit of changes to port input/output permissions.
 349
 350 SYSCALLS:
 351 ioperm()
 352
 353 TESTCASE: successful
 354 Set port permissions as root user.
 355
 356 TESTCASE: unsuccessful
 357 Attempt to set port permissions as test user.
 358
 359  ---
 360
 361 FILE:
 362 test_iopl.c
 363
 364 PURPOSE:
 365 Verify audit of changes to process I/O privilege level.
 366
 367 SYSCALLS:
 368 iopl()
 369
 370 TESTCASE: successful
 371 Set I/O privilege level as root user.
 372
 373 TESTCASE: unsuccessful
 374 Attempt to set I/O privilege level as test user.
 375
 376  ---
 377
 378 FILE:
 379 test_lchown.c
 380
 381 PURPOSE:
 382 Verify audit of attempts to change file owner and group.
 383
 384 SYSCALLS:
 385 lchown(), lchown32()
 386
 387 TESTCASE: file successful
 388 Change a file's owner and group as the superuser.
 389
 390 TESTCASE: file unsuccessful
 391 Attempt to change a file's owner and group as regular user.
 392
 393 TESTCASE: symlink successful
 394 Change a symlink's owner and group as the superuser.
 395
 396 TESTCASE: symlink unsuccessful
 397 Attempt to change a symlink's owner and group as regular user.
 398
 399  ---
 400
 401 FILE:
 402 test_link.c
 403
 404 PURPOSE:
 405 Verify audit of attempts to create hard links.
 406
 407 SYSCALLS:
 408 link()
 409
 410 TESTCASE: successful
 411 Create a hard link in a directory for which user has appropriate
 412 permissions.
 413
 414 TESTCASE: unsuccessful
 415 Attempt to create a hard link in a directory for which user does
 416 not have appropriate permissions.
 417
 418  ---
 419
 420 FILE:
 421 test_lremovexattr.c
 422
 423 PURPOSE:
 424 Verify audit of attempts to remove extended attributes.
 425
 426 SYSCALLS:
 427 lremovexattr()
 428
 429 TESTCASE: file successful
 430 Remove an extended attribute for a file for which user has
 431 appropriate permissions.
 432
 433 TESTCASE: file unsuccessful
 434 Attempt to remove an extended attribute for a file for which
 435 user does not have appropriate permissions.
 436
 437 TESTCASE: symlink successful
 438 Remove an extended attribute for a symlink for which user has
 439 appropriate permissions.
 440
 441 TESTCASE: symlink unsuccessful
 442 Attempt to remove an extended attribute for a symlink for which
 443 user does not have appropriate permissions.
 444
 445  ---
 446
 447 FILE:
 448 test_lsetxattr.c
 449
 450 PURPOSE:
 451 Verify audit of attempts to set extended attribute values.
 452
 453 SYSCALLS:
 454 lsetxattr()
 455
 456 TESTCASE: file successful
 457 Set an extended attribute value for a file for which user has
 458 appropriate permissions.
 459
 460 TESTCASE: file unsuccessful
 461 Attempt to set an extended attribute value for a file for which
 462 user does not have appropriate permissions.
 463
 464 TESTCASE: symlink successful
 465 Set an extended attribute value for a symlink for which user has
 466 appropriate permissions.
 467
 468 TESTCASE: symlink unsuccessful
 469 Attempt to set an extended attribute value for a symlink for which
 470 user does not have appropriate permissions.
 471
 472  ---
 473
 474 FILE:
 475 test_mkdir.c
 476
 477 PURPOSE:
 478 Verify audit of attempts to create directories.
 479
 480 SYSCALLS:
 481 mkdir()
 482
 483 TESTCASE: successful
 484 Create a directory within a directory for which user has
 485 appropriate permissions.
 486
 487 TESTCASE: unsuccessful
 488 Attempt to create a directory within a directory for which user
 489 does not have appropriate permissions.
 490
 491  ---
 492
 493 FILE:
 494 test_mknod.c
 495
 496 PURPOSE:
 497 Verify audit of attempts to create special files.
 498
 499 SYSCALLS:
 500 mknod()
 501
 502 TESTCASE: successful
 503 Create a special file in a directory for which user has
 504 appropriate permissions.
 505
 506 TESTCASE: unsuccessful
 507 Attempt to create a special file in a directory for which user
 508 does not have appropriate permissions.
 509
 510  ---
 511
 512 FILE:
 513 test_mount.c
 514
 515 PURPOSE:
 516 Verify audit of attempts to mount filesystems.
 517
 518 SYSCALLS:
 519 mount()
 520
 521 TESTCASE: successful
 522 Mount a filesystem at a directory for which user has appropriate
 523 permissions.
 524
 525 TESTCASE: unsuccessful
 526 Attempt to mount a filesystem at a directory for which user
 527 does not have appropriate permissions.
 528
 529  ---
 530
 531 FILE:
 532 test_msgctl.c
 533
 534 PURPOSE:
 535 Verify audit of attempts perform message control operations.
 536
 537 SYSCALLS:
 538 msgctl()
 539
 540 TESTCASE: remove successful
 541 Remove a message queue.
 542
 543 TESTCASE: remove unsuccessful
 544 Attempt to remove a message queue with insufficient access
 545 permissions.
 546
 547 TESTCASE: setperms successful
 548 Change message queue permissions.
 549
 550 TESTCASE: setperms unsuccessful
 551 Attempt to change message queue permissions, while having
 552 insufficient access permissions.
 553
 554  ---
 555
 556 FILE:
 557 test_msgget.c
 558
 559 PURPOSE:
 560 Verify audit of attempts to create/get message queue identifiers.
 561
 562 SYSCALLS:
 563 msgget()
 564
 565 TESTCASE: successful
 566 Get identifier for an existing message queue.
 567
 568 TESTCASE: unsuccessful
 569 Attempt to create a new message queue with the key of an existing
 570 message queue (specifying IPC_EXCL).
 571
 572  ---
 573
 574 FILE:
 575 test_msgrcv.c
 576
 577 PURPOSE:
 578 Verify audit of attempts to read messages from a message queue.
 579
 580 SYSCALLS:
 581 msgrcv()
 582
 583 TESTCASE: successful
 584 Read a message from a message queue.
 585
 586 TESTCASE: unsuccessful
 587 Attempt to read a message from a message queue with
 588 insufficient access permissions.
 589
 590  ---
 591
 592 FILE:
 593 test_msgsnd.c
 594
 595 PURPOSE:
 596 Verify audit of attempts to append messages to a message queue.
 597
 598 SYSCALLS:
 599 msgsnd()
 600
 601 TESTCASE: successful
 602 Append a message to a message queue.
 603
 604 TESTCASE: unsuccessful
 605 Attempt to append a message to a message queue with insufficient
 606 access permissions.
 607
 608  ---
 609
 610 FILE:
 611 test_open.c
 612
 613 PURPOSE:
 614 Verify audit of attempts to open files.
 615
 616 SYSCALLS:
 617 open()
 618
 619 TESTCASE: successful
 620 Open a file for which user has access permissions.
 621
 622 TESTCASE: unsuccessful
 623 Attempt to open a file for which user does not have access
 624 permissions.
 625
 626  ---
 627
 628 FILE:
 629 test_ptrace.c
 630
 631 PURPOSE:
 632 Verify audit of attempts to trace a process.
 633
 634 SYSCALLS:
 635 ptrace()
 636
 637 TESTCASE: successful
 638 Perform a PTRACE_ATTACH to a new child process.
 639
 640 TESTCASE: unsuccessful
 641 Attempt to PTRACE_ATTACH to the init process.
 642
 643  ---
 644
 645 FILE:
 646 test_removexattr.c
 647
 648 PURPOSE:
 649 Verify audit of attempts to remove extended attributes.
 650
 651 SYSCALLS:
 652 removexattr()
 653
 654 TESTCASE: file successful
 655 Remove an extended attribute for a file for which user has
 656 appropriate permissions.
 657
 658 TESTCASE: file unsuccessful
 659 Attempt to remove an extended attribute for a file for which
 660 user does not have appropriate permissions.
 661
 662 TESTCASE: symlink successful
 663 Remove an extended attribute for a symlink for which user has
 664 appropriate permissions.
 665
 666 TESTCASE: symlink unsuccessful
 667 Attempt to remove an extended attribute for a symlink for which
 668 user does not have appropriate permissions.
 669
 670  ---
 671
 672 FILE:
 673 test_rename.c
 674
 675 PURPOSE:
 676 Verify audit of attempts change the name or location of a file.
 677
 678 SYSCALLS:
 679 rename()
 680
 681 TESTCASE: successful
 682 Rename a file to the name of an existing file.
 683
 684 TESTCASE: unsuccessful
 685 Attempt to rename a file to the name of an existing file for which
 686 user does not have appropriate permissions to modify.
 687
 688  ---
 689
 690 FILE:
 691 test_rmdir.c
 692
 693 PURPOSE:
 694 Verify audit of attempts to remove a directory.
 695
 696 SYSCALLS:
 697 rmdir()
 698
 699 TESTCASE: successful
 700 Remove a directory for which user has appropriate permissions.
 701
 702 TESTCASE: unsuccessful
 703 Attempt to remove a directory for which user does not
 704 have appropriate permissions.
 705
 706  ---
 707
 708 FILE:
 709 test_semctl.c
 710
 711 PURPOSE:
 712 Verify audit of attempts to perform semaphore control operations.
 713
 714 SYSCALLS:
 715 semctl()
 716
 717 TESTCASE: remove successful
 718 Remove a semaphore set.
 719
 720 TESTCASE: remove unsuccessful
 721 Attempt to remove a semaphore set with insufficient access
 722 permissions.
 723
 724 TESTCASE: setperms successful
 725 Change semaphore set permissions.
 726
 727 TESTCASE: setperms unsuccessful
 728 Attempt to change semaphore set permissions, while having
 729 insufficient access permissions.
 730
 731  ---
 732
 733 FILE:
 734 test_semget.c
 735
 736 PURPOSE:
 737 Verify audit of attempts to create/get semaphore set identifiers.
 738
 739 SYSCALLS:
 740 semget()
 741
 742 TESTCASE: successful
 743 Get identifier for an existing semaphore set.
 744
 745 TESTCASE: unsuccessful
 746 Attempt to create a new semaphore set with the key of an existing
 747 semaphore set (specifying IPC_EXCL).
 748
 749  ---
 750
 751 FILE:
 752 test_semops.c
 753
 754 PURPOSE:
 755 Verify audit of attempts to perform semaphore operations.
 756
 757 SYSCALLS:
 758 semop(), semtimedop()
 759
 760 TESTCASE: successful
 761 Perform a semaphore operation.
 762
 763 TESTCASE: unsuccessful
 764 Attempt to perform a semaphore operation with insufficient access
 765 permissions to the set.
 766
 767  ---
 768
 769 FILE:
 770 test_setfsgid.c
 771
 772 PURPOSE:
 773 Verify audit of attempts to set filesystem group identity.
 774
 775 SYSCALLS:
 776 setfsgid(), setfsgid32()
 777
 778 TESTCASE: modify successful
 779 As root, attempt to set fsgid to test user's gid.
 780
 781 TESTCASE: nomodify successful
 782 As test user with test user gids, attempt to set fsgid to root's gid.
 783
 784 NOTES:
 785 A process's fsgid is equivalent to its egid, unless
 786 explicitly set by setfsgid().
 787
 788 setfsgid() fails when the caller's euid is not root, and the
 789 specified fsgid does not match the caller's current real gid,
 790 egid, sgid or fsgid.
 791
 792 The setfsgid() syscalls do not return any error codes.
 793
 794  ---
 795
 796 FILE:
 797 test_setfsuid.c
 798
 799 PURPOSE:
 800 Verify audit of attempts to set filesystem user identity.
 801
 802 SYSCALLS:
 803 setfsuid(), setfsuid32()
 804
 805 TESTCASE: modify successful
 806 As root, attempt to set fsuid to test user's uid.
 807
 808 TESTCASE: nomodify successful
 809 As test user attempt to set fsuid to test user's uid+1;
 810
 811 NOTES:
 812 A process's fsuid is equivalent to its euid, unless
 813 explicitly set by setfsuid().
 814
 815 setfsuid() fails when the caller's euid is not root, and the
 816 specified fsuid does not match the caller's current real uid,
 817 euid, suid or fsuid.
 818
 819 The setfsuid() syscalls do not return any error codes.
 820
 821  ---
 822
 823 FILE:
 824 test_setgid.c
 825
 826 PURPOSE:
 827 Verify audit of attempts to set effective group identity.
 828
 829 SYSCALLS:
 830 setgid(), setgid32()
 831
 832 TESTCASE: successful
 833 As root, attempt to set egid to test user's gid.
 834
 835 TESTCASE: unsuccessful
 836 As test user with test user gids, attempt to set egid to root's gid.
 837
 838  ---
 839
 840 FILE:
 841 test_setgroups.c
 842
 843 PURPOSE:
 844 Verify audit of attempts to set a process's list of supplementary
 845 group IDs.
 846
 847 SYSCALLS:
 848 setgroups(), setgroups32()
 849
 850 TESTCASE: successful
 851 As root, set the list of supplementary group IDs to the values in
 852 the list returned by getgroups().
 853
 854 TESTCASE: unsuccessful
 855 As test user, attempt to set the list of supplementary group IDs
 856 to the list obtained as root user.
 857
 858  ---
 859
 860 FILE:
 861 test_setregid.c
 862
 863 PURPOSE:
 864 Verify audit of attempts to set real group identity.
 865
 866 SYSCALLS:
 867 setregid(), setregid32()
 868
 869 TESTCASE: successful
 870 As root, attempt to set rgid to the test user's gid.
 871 Effective gid is left unchanged.
 872
 873 TESTCASE: unsuccessful
 874 As test user with test user gids, attempt to set rgid to root's
 875 gid.  Effective gid is left unchanged.
 876
 877  ---
 878
 879 FILE:
 880 test_setresgid.c
 881
 882 PURPOSE:
 883 Verify audit of attempts to set saved group identity.
 884
 885 SYSCALLS:
 886 setresgid(), setresgid32()
 887
 888 TESTCASE: successful
 889 As root, attempt to set saved gid to test user's gid.  Real and
 890 effective gids are left unchanged.
 891
 892 TESTCASE: unsuccessful
 893 AS test user with test user gids, attempt to set saved gid to
 894 root's gid.  Real and effective gids are left unchanged.
 895
 896  ---
 897
 898 FILE:
 899 test_setresuid.c
 900
 901 PURPOSE:
 902 Verify audit of attempts to set saved user identity.
 903
 904 SYSCALLS:
 905 setresuid(), setresuid32()
 906
 907 TESTCASE: successful
 908 As root, attempt to set saved uid to test user's uid.  Real and
 909 effective uids are left unchanged.
 910
 911 TESTCASE: unsuccessful
 912 AS test user, attempt to set saved uid to test user's uid+1;
 913 Real and effective uids are left unchanged.
 914
 915  ---
 916
 917 FILE:
 918 test_setreuid.c
 919
 920 PURPOSE:
 921 Verify audit of attempts to set real user identity.
 922
 923 SYSCALLS:
 924 setreuid(), setreuid32()
 925
 926 TESTCASE: successful
 927 As root, attempt to set real uid to test user's uid.
 928 Effective uid is left unchanged.
 929
 930 TESTCASE: unsuccessful
 931 As test user, attempt to set real uid to test user's uid+1;
 932 Effective uid is left unchanged.
 933
 934  ---
 935
 936 FILE:
 937 test_settimeofday.c
 938
 939 PURPOSE:
 940 Verify audit of attempts to change system time.
 941
 942 SYSCALLS:
 943 settimeofday()
 944
 945 TESTCASE: successful
 946 Set system time as root user.
 947
 948 TESTCASE: unsuccessful
 949 Attempt to set system time as test user.
 950
 951  ---
 952
 953 FILE:
 954 test_setuid.c
 955
 956 PURPOSE:
 957 Verify audit of attempts to set effective user identity.
 958
 959 SYSCALLS:
 960 setuid(), setuid32()
 961
 962 TESTCASE: successful
 963 As root, attempt to set euid to root uid.  Dropping priveleges
 964 with setuid() would result in not being able to resume priveleges
 965 to search the audit log for the resulting record.
 966
 967 TESTCASE: unsuccessful
 968 As test user, attempt to set euid to test user's uid+1;
 969
 970  ---
 971
 972 FILE:
 973 test_setxattr.c
 974
 975 PURPOSE:
 976 Verify audit of attempts to set extended attribute values.
 977
 978 SYSCALLS:
 979 setxattr()
 980
 981 TESTCASE: file successful
 982 Set an extended attribute value for a file for which user has
 983 appropriate permissions.
 984
 985 TESTCASE: file unsuccessful
 986 Attempt to set an extended attribute value for a file for which
 987 user does not have appropriate permissions.
 988
 989 TESTCASE: symlink successful
 990 Set an extended attribute value for a symlink for which user has
 991 appropriate permissions.
 992
 993 TESTCASE: symlink unsuccessful
 994 Attempt to set an extended attribute value for a symlink for which
 995 user does not have appropriate permissions.
 996
 997  ---
 998
 999 FILE:
1000 test_shmat.c
1001
1002 PURPOSE:
1003 Verify audit of attempts to attach to a shared memory segment.
1004
1005 SYSCALLS:
1006 shmat()
1007
1008 TESTCASE: remove successful
1009 Attach to an existing shared memory segment.
1010
1011 TESTCASE: remove unsuccessful
1012 Attempt to attach to an existing shared memory segment with
1013 insufficient access permissions.
1014
1015  ---
1016
1017 FILE:
1018 test_shmctl.c
1019
1020 PURPOSE:
1021 Verify audit of attempts to perform shared memory control operations.
1022
1023 SYSCALLS:
1024 shmctl()
1025
1026 TESTCASE: remove successful
1027 Mark a shared memory segment as destroyed.
1028
1029 TESTCASE: remove unsuccessful
1030 Attempt to mark a shared memory segment as destroyed with
1031 insufficient access permissions.
1032
1033 TESTCASE: setperms successful
1034 Change shared memory segment permissions.
1035
1036 TESTCASE: setperms unsuccessful
1037 Attempt to change shared memory segment permissions, while having
1038 insufficient access permissions.
1039
1040  ---
1041
1042 FILE:
1043 test_shmget.c
1044
1045 PURPOSE:
1046 Verify audit of attempts to create/get identifiers for shared
1047 memory segments.
1048
1049 SYSCALLS:
1050 shmget()
1051
1052 TESTCASE: successful
1053 Get identifier for an existing shared memory segment.
1054
1055 TESTCASE: unsuccessful
1056 Attempt to create a new shared memory segment with the key of an
1057 existing shared memory segment (specifying IPC_EXCL).
1058
1059  ---
1060
1061 FILE:
1062 test_stime.c
1063
1064 PURPOSE:
1065 Verify audit of attempts to change system time.
1066
1067 SYSCALLS:
1068 stime()
1069
1070 TESTCASE: successful
1071 Set system time as root user.
1072
1073 TESTCASE: unsuccessful
1074 Attempt to set system time as test user.
1075
1076  ---
1077
1078 FILE:
1079 test_swapon.c
1080
1081 PURPOSE:
1082 Verify audit of attempts to start swapping to a file/device.
1083
1084 SYSCALLS:
1085 swapon()
1086
1087 TESTCASE: successful
1088 Start swapping to a file as the super user.
1089
1090 TESTCASE: unsuccessful
1091 Attempt to start swapping to a file as an unprivileged user.
1092
1093
1094  ---
1095
1096
1097 This program is free software: you can redistribute it and/or modify
1098 it under the terms of version 2 the GNU General Public License as
1099 published by the Free Software Foundation.
1100
1101 This program is distributed in the hope that it will be useful,
1102 but WITHOUT ANY WARRANTY; without even the implied warranty of
1103 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
1104 GNU General Public License for more details.
1105
1106 You should have received a copy of the GNU General Public License
1107 along with this program.  If not, see <http://www.gnu.org/licenses/>.
1108
1109 Implementation written by HP, based on original code from IBM.
1110
1111 FILE:
1112 test_symlink.c
1113
1114 PURPOSE:
1115 Verify audit of attempts to create symbolic links.
1116
1117 SYSCALLS:
1118 symlink()
1119
1120 TESTCASE: successful
1121 Create a symlink in a directory for which user has appropriate
1122 permissions.
1123
1124 TESTCASE: unsuccessful
1125 Attempt to create a symlink in a directory for which user does
1126 not have appropriate permissions.
1127
1128  ---
1129
1130 FILE:
1131 test_truncate.c
1132
1133 PURPOSE:
1134 Verify audit of attempts to truncate a file to a specified length.
1135
1136 SYSCALLS:
1137 truncate(), truncate64()
1138
1139 TESTCASE: successful
1140 Trucate a file for which user has appropriate permissions.
1141
1142 TESTCASE: unsuccessful
1143 Attempt to truncate a file for which user does not have
1144 appropriate permissions.
1145
1146  ---
1147
1148 FILE:
1149 test_umask.c
1150
1151 PURPOSE:
1152 Verify audit of changes to file creation mask.
1153
1154 SYSCALLS:
1155 umask()
1156
1157 TESTCASE: successful
1158 Set umask to current umask value.
1159
1160 NOTES:
1161 umask() always succeeds.
1162
1163  ---
1164
1165 FILE:
1166 test_unlink.c
1167
1168 PURPOSE:
1169 Verify audit of attempts to remove a name from the filesystem.
1170
1171 SYSCALLS:
1172 unlink()
1173
1174 TESTCASE: successful
1175 Remove a name for which user has appropriate permissions.
1176
1177 TESTCASE: unsuccessful
1178 Attempt to remove a name for which user does not have appropriate
1179 permissions.
1180
1181  ---
1182
1183 FILE:
1184 test_utime.c
1185
1186 PURPOSE:
1187 Verify audit of attempts to change file access/modification times.
1188
1189 SYSCALLS:
1190 utime(), utimes()
1191
1192 TESTCASE: successful
1193 Change file access and modification times for a file for which
1194 user has appropriate permissions.
1195
1196 TESTCASE: unsuccessful
1197 Attempt to change file access and modification times for a file
1198 for which user does not have appropriate permissions.