Documentation/TODO

   1
   2  Note that items with (!) have high priority.
   3
   4 col
   5 ---
   6   - use unsigned sizes for columns and lines
   7   - check for limits to avoid segfaults
   8   - make it more robust
   9   https://github.com/karelzak/util-linux/issues/749
  10
  11 cal
  12 ---
  13    - add option to print calendar in vertical way
  14      https://github.com/karelzak/util-linux/issues/604
  15    - support another --reforms, see for example freebsd version
  16      https://github.com/freebsd/freebsd/blob/master/usr.bin/ncal/ncal.c#L72
  17
  18 script
  19 ------
  20    - introduce a new timing file format to record information about multiple
  21      streams (stdout, stdin) and events (signals)
  22
  23    - add support for stdin loggin -- separated log file with raw input and timing
  24      records in the timing file
  25
  26    - for example timing file format:
  27
  28              <type> <timestamp> [<offset> | <signal> ...]
  29
  30              O 0.001296 256
  31              S 0.001297 SIGWINCH: columns=50, lines=20
  32              I 0.000010 10
  33
  34      O - output, S - signal, I - input
  35
  36
  37 lscpu
  38 -----
  39   - add --list-caches to print details from /sys/devices/system/cpu/cpu0/cache/index*/*
  40     about caches, for example:
  41
  42     NAME SIZE  ITEM-SIZE   TYPE          Ways
  43     L3   126M         8M   Data             8
  44     L2    22M       512K   Instruction      4
  45
  46     See https://github.com/karelzak/util-linux/issues/663
  47
  48   - read cpuid and uname information from file if --sysroot is specified, then
  49     we can prepare regression tests completely independent on hw and architecture.
  50
  51 lsblk
  52 -----
  53   - currently it does not show mountpoint for all devices in btrfs RAID. It's because
  54     /proc/#/mountinfo contains reference to the one device only. Maybe we can add some
  55     btrfs specific code to provide a better output for FS based stacks. Not sure.
  56     https://bugzilla.redhat.com/show_bug.cgi?id=1084453
  57
  58 nsenter(1)
  59 ----------
  60  - read the default UID and GID from the target process.
  61    http://thread.gmane.org/gmane.linux.utilities.util-linux-ng/9553/focus=9585
  62
  63 hwlock
  64 ------
  65  - use /var/lib/hwclock/drift to store hw-clock drift numbers.
  66  - use /etc/adjtime as read-only for UTC/LOCAL information only
  67  - the /var/lib/hwclock/drift should be implemented backwardly compatible,
  68    it means use the file only if exists, otherwise follow /etc/adjtime
  69
  70 bash completion
  71 ---------------
  72 - Optional argument handling requires user to press backspace to get
  73   argument completion.
  74 - Comma separated value, e.g., --output 'value1,value2', are not
  75   completed for users.
  76
  77 libmount (mount/umount)
  78 -----------------------
  79
  80  - add --onlyonce to force mount(8) to check if mountpoint is already used. Now
  81    "already mounted" detection is used for --all only. The problem is if you
  82    call "mount <mountpoint>" more than once for in fstab defined tmpfs (or network
  83    filesystem etc.). In this case kernel does not return EBUSY, but a new instance
  84    of the FS is created. https://github.com/karelzak/util-linux/issues/448
  85    (... just idea, maybe wrong idea)
  86
  87  - support CAP_SYS_ADMIN; for mount(2) syscall the CAP_SYS_ADMIN is good
  88    enough. Unfortunately, mount(8) does more things like check for filesystem
  89    type (but it's usually done by udev, so root perms are unnecessary), create
  90    loop devices, write to /run/mount/utab or /etc/mtab, etc.
  91
  92    It would be nice to improve libmount to check for CAP_SYS_ADMIN if suid not
  93    set and allow to use it for simple tasks where no another operation is
  94    necessary.
  95
  96 partx
  97 -----
  98
  99  - support mapping by device-mapper if argv[0] is "kpartx" or --dm option is used.
 100
 101
 102 getopt
 103 ------
 104   It would be great if getopt could optionally ignore unknown options.
 105   Currently, it outputs -- for every option it doesn't recognize but leaving the
 106   option as it is could beneficial wrapper scripts which could then pass the
 107   options they don't recognize as they are to the command they are wrapping.
 108   https://github.com/karelzak/util-linux/issues/701
 109
 110 docs
 111 ----
 112
 113  - (!) use something better than gtk-doc for libmount and libblkid (doxyden?)
 114
 115  - (!) add API documentation to libuuid
 116
 117
 118 login-utils:
 119 -----------
 120
 121   - consolidate newgrp(1)
 122     * we have "su --group/--supp-group" to switch between groups, newgrp(1) in
 123       util-linux and shadow-utils (and sg(1) alias in shadow-utils)
 124     * the unique functionality provided by newgpr(1) is support for group
 125       passwords [/etc/gshadow] -- do we really need this functionality?
 126     * maybe we can mark group-passwords as deprecated, and replace sg(1) and
 127       newgpr(1) with su(1) code. The another way is to ask for group password in
 128       su --group too.
 129     * note that shadow-utils newgpr(1) provides support for syslog and audit log.
 130
 131
 132 libblkid
 133 --------
 134
 135  - (!) add support for BitLocker Drive Encryption
 136    https://github.com/karelzak/util-linux/issues/617
 137    https://github.com/libyal/libbde/blob/master/documentation/BitLocker%20Drive%20Encryption%20(BDE)%20format.asciidoc
 138
 139  - (!) add support for dasd PT (used for example on s390)
 140
 141 libfdisk
 142 --------
 143
 144  - add support for Apple Partition Map (see libblkid/src/partitions/mac.c)
 145    http://en.wikipedia.org/wiki/Apple_Partition_Map
 146
 147
 148 misc
 149 ----
 150
 151  - add mllockall() and SCHED_FIFO to hwclock,
 152    see http://lkml.org/lkml/2008/10/12/132
 153
 154
 155 ---------------
 156 exotic requests
 157 ---------------
 158
 159  - add SELinux security contexts support to the 'ipcs' utility
 160    http://bugzilla.redhat.com/show_bug.cgi?id=225342
 161
 162    Would be great to list the current system IPC Objects with their respective
 163    security labels (where allowed) with something like 'ipcs -Z' - following the
 164    way other tools reports those.
 165
 166