tizen 2.0
[framework/base/util-linux-ng.git] / README
1
2                           utils-linux-ng
3            (fork of util-linux, based on version 2.13-pre7)
4
5          util-linux is a random collection of Linux utilities
6
7 WEB PAGE:
8
9      http://kernel.org/~kzak/util-linux-ng/
10
11
12 MAILING LIST:
13
14       E-MAIL: util-linux-ng@vger.kernel.org
15       URL:    http://vger.kernel.org/vger-lists.html#util-linux-ng
16
17
18 DOWNLOAD:
19
20       ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/
21
22
23 SOURCE CODE:
24
25       Web interface:
26           http://git.kernel.org/?p=utils/util-linux-ng/util-linux-ng.git
27       Checkout:
28           git clone git://git.kernel.org/pub/scm/utils/util-linux-ng/util-linux-ng.git util-linux-ng
29
30 NLS (PO TRANSLATIONS):
31
32       PO files are maintained by:
33           http://translationproject.org/domain/util-linux-ng.html
34
35 NEUTRALITY:
36
37       The stuff in util-linux-ng should be rather distribution-neutral.
38       No RPMs/DEBs/... are provided - get yours from your distributor.
39
40
41 VERSION SCHEMA:
42
43       Standard releases:
44
45           <major>.<minor>[.<maint>[.<bugfix>]]
46
47              major = fatal and deep changes
48              minor = typical release with new fetures
49              maint = maintenance releases; bug fixes only
50              bugfix = unplanned releases for critical/security bugs
51
52       Development releases:
53
54          <major>.<minor><suffix>
55
56              suffix = "devel" or "-rc<N>"
57
58
59 COMPILATION:
60
61       See the INSTALL file for more details.
62
63       Notes:
64             * use SUID_CFLAGS and SUID_LDFLAGS when you want to define special
65               compiler options for typical suid programs, for example:
66
67                   ./configure SUID_CFLAGS="-fpie" SUID_LDFLAGS="-pie"
68
69               This feature is currently supported for chfn, chsh, newgrp,
70               write, mount, and umount.
71
72
73 STATIC LINKING:
74
75       Use --enable-static-programs[=LIST] configure option when you want to use
76       statically linked programs.
77
78       Note, mount(8) uses get{pw,gr}nam() and getpwuid() functions for
79       translation from username and groupname to UID and GID. These functions
80       could be implemented by dynamically loaded independent modules (NSS) in
81       your libc (e.g. glibc). These modules are not statically linked to mount(8)
82       and mount.static is still using dlopen() like dynamically linked version.
83
84       The translation won't be work in environment where is not installed the
85       NSS modules.
86
87       For example normal system (NSS modules are available):
88
89               # ./mount.static -v -f -n -ouid=kzak /mnt/foo
90               LABEL=/mnt/foo on /mnt/foo type vfat (rw,uid=500)
91                                                        ^^^^^^^
92       and without NSS modules:
93
94               # chroot . ./mount.static -v -f -n -ouid=kzak /mnt/win
95               LABEL=/mnt/win on /mnt/win type vfat (rw,uid=kzak)
96                                                        ^^^^^^^^
97
98