]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
docs: update TODO file
authorKarel Zak <kzak@redhat.com>
Thu, 28 Jul 2011 11:16:31 +0000 (13:16 +0200)
committerKarel Zak <kzak@redhat.com>
Thu, 28 Jul 2011 11:16:31 +0000 (13:16 +0200)
Signed-off-by: Karel Zak <kzak@redhat.com>
TODO

diff --git a/TODO b/TODO
index 2450f1b3df66477c5f0fbb051d52c0ae1b1f0dc5..c3004c0726b96a564f84744a4181c6b7ac524374 100644 (file)
--- a/TODO
+++ b/TODO
@@ -1,30 +1,25 @@
 
-lscpu
------
-
-  - add -o <list> to speficy output columns for -p options.
-    (the same thing we use for findmnt, lsblk, ...)
+ Note that items with (!) have high priority.
 
 dmesg
 -----
 
- - add -f (follow) option
+ - add --follow option
    http://www.spinics.net/lists/util-linux-ng/msg04453.html
 
-mount
------
-
- (features for new libmount based implemenation)
+ - add --color to colorize err and panic messages
 
- - add support for "x-" namespace for mount options. All options with "x-"
-   prefix should be ignored. 
+libmount (mount/umount)
+-----------------------
 
-   For example x-systemd=, x-upstart-foo, x-libmount-debug=0xffff, ...  
+ Note that the old mount/[u]mount.c code is in MAINTENANCE MODE only. All new
+ features should be implemented to libmount or to the new mount/umount
+ implementation in the libmount/samples/ directory.
 
-   It's definitely better to have a generic way how ignore some options than
-   use comment= for all things.
+ - (!!!) add libmount based umount(8) (see libmount/samples/ where is new mount(8) 
+   implementation.
 
- - add --source and --target options to specify device and mountpoint
+ - (!) add --source and --target options to specify device and mountpoint
 
      fstab:
         /dev/sda1 /foo auto    defaults 0 0
@@ -46,10 +41,28 @@ mount
 
    to create a new hierarchy of filesystems at $FOO_ROOT.
 
+ - umount by label:
+       # mount LABEL=mylabel
+       # umount LABEL=mylabel
+
+losetup
+-------
+
+ - (!!!) use new lib/sysfs.c code for losetup(8), the new implementation should
+   be moved to sys-utils/losetup.c.
+
+ - (!!!) add support for LOOP_CTL_ ioctls (probably will be in kernel 3.1 or 3.2)
+
+libblkd and libmountL
+----------------------------
+
+ - use __attribute__((notnull)) and __attribute__((warn_unused_result))
+   Note that the code has to be usefull for non-gcc compilers too.
+
 partx
 -----
 
- - add support loop devices:
+ - (!) add support loop devices:
 
        partx -a /path/file.img
 
@@ -58,12 +71,27 @@ partx
 
  - support mapping by device-mapper if argv[0] is "kpartx" or --dm option is used.
      
- - add regression tests for partx, addpart and delpart
+ - (!) add regression tests for partx, addpart and delpart
+
+
+docs
+----
+
+ - (!) use something better than gtk-doc for libmount and libblkid (doxyden?)
+
+ - (!) add API documentation to libuuid
 
+ - add Documentation/ directory with:
+          - man page template 
+          - usage() HOW-TO
+          - move README.devel to the Documentation/
 
 build-sys
 --------
 
+ - use non-recursive build-sys, see
+   http://thread.gmane.org/gmane.linux.utilities.util-linux-ng/3297
+
  - we use something like
 
        AC_ARG_ENABLE(...., enable_foo=check)
@@ -73,7 +101,7 @@ build-sys
                        build_foo=no
                fi
        fi
-       AM_CONDITIONAL(BUILD_LIBMOUNT, test "x$build_foo" = xyes)
+       AM_CONDITIONAL(BUILD_FOO, test "x$build_foo" = xyes)
 
    for Linux-only utils in configure.ac. It would be nice to set all defaults
    for all "$enable_" variables at the begin of the configure script according to
@@ -104,26 +132,6 @@ login-utils:
 
  - use err() and warn() macros rather than fprintf(stderr, ...)
 
-losetup
--------
-
- - don't use ioclts if sysfs supports loop attributes (since 2.6.37,
-   block/loopN/loop/* files)
-
-    - don't open loopdev in looplist_next(), check if /sys/block/loopN/loop
-      exists and returns ll.name rather than file descriptor
-
-    - add sysfs based version of show_loop() and use it for non-root users
-
- - move all loopdev code to libmount
-
-
-shlib (libblkd and libmount):
-----------------------------
-
- - use __attribute__((notnull)) and __attribute__((warn_unused_result))
-   Note that the code has to be usefull for non-gcc compilers too.
-
 libblkid
 --------
 
@@ -135,13 +143,13 @@ libblkid
 
  - add FSSIZE value  -- filesystem size (klibc requirement)
 
- - add support for dasd PT (used for example on s390)
+ - (!) add support for dasd PT (used for example on s390)
 
- - support PARTUUID= tag
+ - (!!!) support PARTUUID= tag
 
    * the partitions probing is already supported by low-level part of the
      library, but it's necessary add support for this tag also to high-level
-     (blkid_cache) API.
+     blkid_cache and blkid_evaluate_* APIs
 
    * add blkid -P <PARTUUID>
 
@@ -152,27 +160,29 @@ wipefs
    one magic string the FS is still detectable by libblkid. We have to inform
    users that there is more valid magic string for the same FS.
 
+ - (!!!) allow to wipe partition tables
+
 fdisk(s)
 --------
 
* add "move end" command to move end of the last primary/extended partition.
- add "move end" command to move end of the last primary/extended partition.
    This feature seems very attractive to users who resizing their disks 
    (for example in virtual machines).
 
* sfdisk has to use rpmatch() for answers to y/n questions
- sfdisk has to use rpmatch() for answers to y/n questions
    (e.g. "Are you satisfied with this? [ynq]")
 
* sfdisk rounds to cylinders is -uM (megabyte units) is specified, this is
- sfdisk rounds to cylinders is -uM (megabyte units) is specified, this is
    pretty stupid feature. It has to round to sectors if -uS or -uM is specified.
 
* Sun label support is completely useless for large disks, it uses number of
- Sun label support is completely useless for large disks, it uses number of
    cylinders from on-disk-label where the geometry is stored by int16 values.
    It seems better to completely ignore this stuff from the label and always
    use geometry + BLKGETSIZE64 from kernel.
 
* use off_t instead "long long"
- use off_t instead "long long"
 
* catch SIGINT (Ctrl-C) and return to main menu.
- catch SIGINT (Ctrl-C) and return to main menu.
    From Red Hat bugzilla #545488:
 
    While using fdisk normally, if you accidentally pressed the wrong button (to
@@ -181,18 +191,18 @@ fdisk(s)
    can't provide a blank or invalid input to get it to break out of the current
    dialog sequence and get back to the main menu.
 
- * fdisk/* refactoring
+ - fdisk/* refactoring (probably implement libfdisk ???)
 
* add GPT support (probably implement libfdisk)
- add GPT support (probably implement libfdisk ???)
 
 misc
 ----
 
* switch_root:
- switch_root:
      - move all mountpoints to the newroot (there are hardcoded /proc /sys and /dev paths now)
      - add --dont-move[=<list of dirs>] options
 
* use ngettext() for strings with plurals, for example
- use ngettext() for strings with plurals, for example
 
     /* include/nls.h */
     #define P_(id, id_plural, n)       ngettext(id, id_plural, n)
@@ -201,27 +211,21 @@ misc
               "%d used sectors", sectors),
               sectors);
 
- * use something better than gtk-doc (doxyden?)
-
- * use TZ=UTC and LANG=en_US.UTF-8 for tests
+ - use TZ=UTC and LANG=en_US.UTF-8 for tests
 
* add mllockall() and SCHED_FIFO to hwclock,
- add mllockall() and SCHED_FIFO to hwclock,
    see http://lkml.org/lkml/2008/10/12/132
  
- * use rpmatch() for all Y/N questions
-
- * umount by label:
-       # mount LABEL=mylabel
-       # umount LABEL=mylabel
+ - use rpmatch() for all Y/N questions
 
 
 ---------------
 exotic requests
 ---------------
 
* mount -a -- reorder fstab entries by paths before mount (just idea only)
- mount -a -- reorder fstab entries by paths before mount (just idea only)
 
* mount -a  (just idea only)
- mount -a  (just idea only)
 
         Date:   Sun, 3 Jun 2007 18:04:24 +0300 (MET DST)
         From: Szabolcs Szakacsits <szaka@sienet.hu>
@@ -256,22 +260,11 @@ exotic requests
                try to mount all unmounted entries
          } while (not all mounted && at least one new was successfully mounted)
 
* rewrite ipcs to use /proc/sys/kernel rather than unreliable syscalls
- rewrite ipcs to use /proc/sys/kernel rather than unreliable syscalls
    (there are problems with 32bit userspace on 64bit kernel)
 
- * minix v3
-
-       From: Matthias Koenig <mkoenig@suse.de>
-       Date:   Tue, 25 Sep 2007 12:00:01 +0200
-
-       It seems that the kernel has support for minix fs v3
-       (though I have not tried it, just inspected some code when
-       trying to find a mkfs.minix issue).
-       It might be worth a thought implementing v3 support
-       (though I am not really sure how much people us minix fs ;-)
-       This might require some major code cleanup in mkfs.minix.
 
* add SELinux security contexts support to the 'ipcs' utility
- add SELinux security contexts support to the 'ipcs' utility
    http://bugzilla.redhat.com/show_bug.cgi?id=225342
 
    Would be great to list the current system IPC Objects with their respective