FM / util-linux

/usr/share/doc/util-linux

Name	Size	Mode	Actions
examples/	-	0755	rm
releases/	-	0755	rm
00-about-docs.txt	260	0644	edit dl rm
AUTHORS.gz	15113	0644	edit dl rm
blkid.txt	3258	0644	edit dl rm
cal.txt	2262	0644	edit dl rm
changelog.Debian.gz	2654	0644	edit dl rm
col.txt	1913	0644	edit dl rm
copyright	23045	0644	edit dl rm
deprecated.txt	3086	0644	edit dl rm
getopt.txt	992	0644	edit dl rm
getopt_changelog.txt	1927	0644	edit dl rm
howto-build-sys.txt	3193	0644	edit dl rm
howto-compilation.txt	2945	0644	edit dl rm
howto-contribute.txt.gz	3437	0644	edit dl rm
howto-debug.txt	2437	0644	edit dl rm
howto-man-page.txt	126	0644	edit dl rm
howto-pull-request.txt.gz	4260	0644	edit dl rm
howto-tests.txt.gz	1706	0644	edit dl rm
howto-usage-function.txt.gz	2328	0644	edit dl rm
hwclock.txt	147	0644	edit dl rm
modems-with-agetty.txt	2614	0644	edit dl rm
mount.txt	521	0644	edit dl rm
NEWS.Debian.gz	1897	0644	edit dl rm
PAM-configuration.txt	671	0644	edit dl rm
parse-date.txt.gz	8124	0644	edit dl rm
pg.txt	448	0644	edit dl rm
poeigl.txt.gz	8867	0644	edit dl rm
README.Debian	481	0644	edit dl rm
release-schedule.txt	1354	0644	edit dl rm

Edit: /usr/share/doc/util-linux/howto-compilation.txt (2945B)

The common case

./autogen.sh && ./configure && make

If something fails read the last lines. Typical reason to
	  fail is a missing dependency, such as libtool or gettext.

make install-strip

Note that on the production systems it is strongly recommended to use
	  "make install-strip" to install binaries and libraries. The result
	  from the standard "make install" may produce large binaries with
	  unnecessary symbols.

Autotools

`./autogen.sh' generates all files needed to compile
	and install the code (run it after checkout from git)

`make distclean' removes all unnecessary files, but the
	code can still be recompiled with "./configure; make"

`make dist-gzip' (or -bzip2) creates a tarball that can
	be configured and compiled without running `./autogen.sh'

Compiling

Use SUID_CFLAGS and SUID_LDFLAGS when you want to define
	special compiler options for typical suid programs, for
	example:

./configure SUID_CFLAGS="-fpie" SUID_LDFLAGS="-pie"

The SUID_* feature is currently supported for chfn, chsh,
	newgrp, su, write, mount, and umount.

Use DAEMON_CFLAGS and DAEMON_LDFLAGS when you want to define
	special compiler options for daemons; supported for uuidd.

Use SOLIB_CFLAGS and SOLIB_LDFLAGS when you want to define
	special compiler options for shared libraries; supported for
	libmount, libblkid and libuuid.

FIXME: add notes about klib and uClib.

Compile certain portion

See ./configure --help and use --disable-* and --enable-* options.

It's also possible to disable all the programs and enable only wanted.
        For example:

./configure --disable-all-programs --enable-fallocate

Note that the configure script tracks dependencies between libs and
        tools. Always see warning messages and follow error messages if any
        dependence is necessary. For example to compile mount(8) you need also
        libmount, libblkid and libuuid:

./configure --disable-all-programs --enable-mount --enable-libmount \
                    --enable-libblkid --enable-libuuid

Static linking

Use --enable-static-programs[=LIST] configure option when
	you want to use statically linked programs.

Note, mount(8) uses get{pw,gr}nam() and getpwuid()
	functions for translation from username and groupname to
	UID and GID. These functions could be implemented by
	dynamically loaded independent modules (NSS) in your libc
	(e.g. glibc). These modules are not statically linked to
	mount(8) and mount.static is still using dlopen() like
	dynamically linked version.

The translation won't work in environment where NSS
	modules are not installed.

For example normal system (NSS modules are available):

# ./mount.static -v -f -n -ouid=kzak /mnt/foo
		LABEL=/mnt/foo on /mnt/foo type vfat (rw,uid=500)
							 ^^^^^^^
	and without NSS modules:

# chroot . ./mount.static -v -f -n -ouid=kzak /mnt/win
		LABEL=/mnt/win on /mnt/win type vfat (rw,uid=kzak)
							 ^^^^^^^^

The common case ./autogen.sh && ./configure && make If something fails read the last lines. Typical reason to fail is a missing dependency, such as libtool or gettext. make install-strip Note that on the production systems it is strongly recommended to use "make install-strip" to install binaries and libraries. The result from the standard "make install" may produce large binaries with unnecessary symbols. Autotools `./autogen.sh' generates all files needed to compile and install the code (run it after checkout from git) `make distclean' removes all unnecessary files, but the code can still be recompiled with "./configure; make" `make dist-gzip' (or -bzip2) creates a tarball that can be configured and compiled without running `./autogen.sh' Compiling Use SUID_CFLAGS and SUID_LDFLAGS when you want to define special compiler options for typical suid programs, for example: ./configure SUID_CFLAGS="-fpie" SUID_LDFLAGS="-pie" The SUID_* feature is currently supported for chfn, chsh, newgrp, su, write, mount, and umount. Use DAEMON_CFLAGS and DAEMON_LDFLAGS when you want to define special compiler options for daemons; supported for uuidd. Use SOLIB_CFLAGS and SOLIB_LDFLAGS when you want to define special compiler options for shared libraries; supported for libmount, libblkid and libuuid. FIXME: add notes about klib and uClib. Compile certain portion See ./configure --help and use --disable-* and --enable-* options. It's also possible to disable all the programs and enable only wanted. For example: ./configure --disable-all-programs --enable-fallocate Note that the configure script tracks dependencies between libs and tools. Always see warning messages and follow error messages if any dependence is necessary. For example to compile mount(8) you need also libmount, libblkid and libuuid: ./configure --disable-all-programs --enable-mount --enable-libmount \ --enable-libblkid --enable-libuuid Static linking Use --enable-static-programs[=LIST] configure option when you want to use statically linked programs. Note, mount(8) uses get{pw,gr}nam() and getpwuid() functions for translation from username and groupname to UID and GID. These functions could be implemented by dynamically loaded independent modules (NSS) in your libc (e.g. glibc). These modules are not statically linked to mount(8) and mount.static is still using dlopen() like dynamically linked version. The translation won't work in environment where NSS modules are not installed. For example normal system (NSS modules are available): # ./mount.static -v -f -n -ouid=kzak /mnt/foo LABEL=/mnt/foo on /mnt/foo type vfat (rw,uid=500) ^^^^^^^ and without NSS modules: # chroot . ./mount.static -v -f -n -ouid=kzak /mnt/win LABEL=/mnt/win on /mnt/win type vfat (rw,uid=kzak) ^^^^^^^^