You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Karel Zak 420bce887d build-sys: move login-utils/logindefs.c to lib 6 months ago
.github/workflows ci: add a GHAction sending data to Coverity 11 months ago
Documentation docs: update v2.38-ReleaseNotes 6 months ago
bash-completion hwclock: add --param-set option 8 months ago
config build-sys: gtkdoc-fixxref v1.27 requires module option 5 years ago
disk-utils partx: remove memory leak to make scanners happy [coverity scan] 7 months ago
include build-sys: move login-utils/logindefs.c to lib 6 months ago
lib build-sys: move login-utils/logindefs.c to lib 6 months ago
libblkid libblkid: make blkid_free_probe() more robust 7 months ago
libfdisk docs: update copyright years 7 months ago
libmount libmount: fix possible memory leak in mnt_optstr_fix_secontext() [coverity scan] 7 months ago
libsmartcols docs: update copyright years 7 months ago
libuuid libuuid: extend cache in uuid_generate_time_generic() 7 months ago
login-utils build-sys: move login-utils/logindefs.c to lib 6 months ago
m4 build-sys: use $LIBS rather than LDFLAGS 1 year ago
man-common colors.adoc: format command name bold 8 months ago
misc-utils hardlink: require statfs_magic.h only when reflink support enabled 6 months ago
po po: merge changes 6 months ago
po-man po-man: merge changes 6 months ago
schedutils man pages: unify output of --help and --version 8 months ago
sys-utils flock: Decribe limitations of flock: deadlock, NFS, CIFS 7 months ago
term-utils agetty: cleanup login prompt macro use 6 months ago
tests tests: remove readline from build-sys output 7 months ago
text-utils column: implement "--output-width unlimited" 6 months ago
tools tools: add git-tp-sync-man 7 months ago
.editorconfig add .editorconfig 7 years ago
.gitignore lsfd: initial commit 1 year ago
AUTHORS docs: update AUTHORS file 6 months ago
COPYING docs: corrections to FSF license files, and postal address 11 years ago
ChangeLog docs: Correct ChangeLog URL to history log. 2 years ago
Makefile.am build-sys: distribute Meson files 7 months ago
NEWS build-sys: release++ (v2.38) 6 months ago
README docs: update IRC address 11 months ago
README.licensing docs: add GPLv3 text 3 years ago
autogen.sh build-sys: use set +e before patch --try in ./autogen.sh 12 months ago
configure.ac build-sys: release++ (v2.38) 6 months ago
meson.build meson: fix bash_completion.get_variable() use 9 months ago
meson_options.txt meson: make raw(7) optional 1 year ago
util-linux.doap docs: update github URL 11 months ago

README


util-linux

util-linux is a random collection of Linux utilities

Note: for the years 2006-2010 this project was named "util-linux-ng".

COMPILE & INSTALL:

See Documentation/howto-compilation.txt.

MAILING LIST:

E-MAIL: util-linux@vger.kernel.org
URL: http://vger.kernel.org/vger-lists.html#util-linux
ARCHIVE: https://lore.kernel.org/util-linux/

The mailing list will reject email messages that contain:
- more than 100K characters
- html
- spam phrases/keywords
See: http://vger.kernel.org/majordomo-info.html#taboo

IRC CHANNEL:

#util-linux at libera.chat:

irc://irc.libera.chat/util-linux

The IRC channel and Mailing list are for developers and project
maintainers. For end users it is recommended to utilize the
distribution's support system.

BUG REPORTING:

E-MAIL: util-linux@vger.kernel.org
Web: https://github.com/util-linux/util-linux/issues

Bug reports with sensitive or private information: Karel Zak <kzak@redhat.com>

This project has no resources to provide support for distribution specific
issues. For end users it is recommended to utilize the distribution's
support system.

NLS (PO TRANSLATIONS):

PO files are maintained by:
http://translationproject.org/domain/util-linux.html

VERSION SCHEMA:

Standard releases:
<major>.<minor>[.<maint>]
major = fatal and deep changes
minor = typical release with new features
maint = maintenance releases; bug fixes only

Development releases:
<major>.<minor>-rc<N>

SOURCE CODE:

Download archive:
https://www.kernel.org/pub/linux/utils/util-linux/

See also:
Documentation/howto-contribute.txt
Documentation/howto-build-sys.txt
Documentation/howto-pull-request.txt

SCM (Source Code Management) Repository:

Primary repository:
git clone git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git

Backup repository:
git clone git://github.com/util-linux/util-linux.git

Web interfaces:
http://git.kernel.org/cgit/utils/util-linux/util-linux.git
https://github.com/util-linux/util-linux

Note: the GitHub repository may contain temporary development branches too.

The kernel.org repository contains master (current development) and stable/*
(maintenance) branches only. All master or stable/* changes are always pushed
to both repositories at the same time.

Repository Branches: 'git branch -a'
master branch
- current development
- the source for stable releases when deemed ready.
- day-to-day status is: 'it works for me'. This means that its
normal state is useful but not well tested.
- long-term development or invasive changes in active development are
forked into separate 'topic' branches from the tip of 'master'.

stable/ branches
- public releases
- branch name: stable/v<major>.<minor>.
- created from the 'master' branch after two or more release
candidates and the final public release. This means that the stable
releases are committed, tagged, and reachable in 'master'.
- these branches then become forked development branches. This means
that any changes made to them diverge from the 'master' branch.
- maintenance releases are part of, and belong to, their respective
stable branch. As such, they are tags(<major>.<minor>.<maint>) and
not branches of their own. They are not part of, visible in, or
have anything to do with the 'master' development branch. In git
terminology: maintenance releases are not reachable from 'master'.
- when initially cloned (as with the 'git clone' command given above)
these branches are created as 'remote tracking branches' and are
only visible by using the -a or -r options to 'git branch'. To
create a local branch use the desired tag with this command:
'git checkout -b v2.29.2 v2.29.2'

Tags: 'git tag'
- a new tag object is created for every release.
- tag name: v<version>.
- all tags are signed by the maintainer's PGP key.

Known Bugs:
- don't use tag v2.13.1 (created and published by mistake),
use v2.13.1-REAL instead.

WORKFLOW EXAMPLE:

1) development (branch: <master>)

2) master release (tags: v2.29-rc1, v2.29-rc2, v2.29, branch: <master>)

3) development (work on v2.30, branch: <master>)

4) fork -- create a new branch <stable/v2.29> based on tag v2.29

4a) new patches or cherry-pick patches from <master> (branch: <stable/v2.29>)

4b) stable release (tag: v2.29.1, branch: <stable/v2.29>)

4c) more patches; another release (tag: v2.29.2, branch: <stable/v2.29>)

5) master release v2.30 (branch: <master>)
...

where 3) and 4) happen simultaneously.