summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)AuthorFilesLines
2018-10-26CODING_STYLE: briefly mention that fgets() should not be used anymoreLennart Poettering1-0/+4
2018-10-22Merge pull request #10415 from poettering/boot-loader-spec-tweaksLennart Poettering1-26/+69
docs: tweaks to the boot loader spec
2018-10-19boot-loader-spec: drop link to obsolete patchLennart Poettering1-2/+0
This is not what distros use, let's not point users to obsolete stuff.
2018-10-19boot-loader-spec: elaborate on 'architecture' stanza a bit and use it in the ↵Lennart Poettering1-7/+8
example
2018-10-19docs: tweaks to the boot loader specLennart Poettering1-17/+61
A couple of changes: 1. Clearly name the drop-in entry files "Type #1", and the unified kernel images "Type #2", and be clearer that the latter is specific to UEFI. 2. Suffix all directory paths with a trailing "/" to clarify that these are directories. Also, enclose them all in ``. 3. Add introductory paragraph that explains that there is Type #1 and Type #2 and what they are about. 4. Explain that Type #2 is about signed UEFI SecureBoot. 5. Don't claim that $BOOT/loader/ contains really all files defined by the spec, because that's not true, Type #2 images are not located there after all. Fixes: #10399
2018-10-19doc: add a markdown document introducing the boot assessment logicLennart Poettering1-0/+203
2018-10-18docs: use h2 headersMichael Biebl2-10/+10
The primer theme does not add a mouse-over anchor link for h1 headers. So use h2 for subsection headers which looks nicer anyway. Followup for #10421
2018-10-18core: implement per unit journal rate limitingAnita Zhang1-0/+2
Add LogRateLimitIntervalSec= and LogRateLimitBurst= options for services. If provided, these values get passed to the journald client context, and those values are used in the rate limiting function in the journal over the the journald.conf values. Part of #10230
2018-10-17sulogin-shell: Use force if SYSTEMD_SULOGIN_FORCE setAndreas Henriksson1-0/+6
When the root account is locked sulogin will either inform you of this and not allow you in or if --force is used it will hand you passwordless root (if using a recent enough version of util-linux). Not being allowed a shell is ofcourse inconvenient, but at the same time handing out passwordless root unconditionally is probably not a good idea everywhere. This patch thus allows to control which behaviour you want by setting the SYSTEMD_SULOGIN_FORCE environment variable to true or false to control the behaviour, eg. via adding this to 'systemctl edit rescue.service' (or emergency.service): [Service] Environment=SYSTEMD_SULOGIN_FORCE=1 Distributions who used locked root accounts and want the passwordless behaviour could thus simply drop in the override file in /etc/systemd/system/rescue.service.d/override.conf Fixes: #7115 Addresses: https://bugs.debian.org/802211
2018-10-16Set theme jekyll-theme-primerMichael Biebl1-1/+1
This theme uses anchorjs to provide mouse-over anchor links. Closes: #10418
2018-10-16Set theme jekyll-theme-caymanLennart Poettering1-1/+1
2018-10-12Set theme jekyll-theme-minimalLennart Poettering1-1/+1
2018-10-12Set theme jekyll-theme-dinkyLennart Poettering1-1/+1
2018-10-12Create CNAMELennart Poettering1-0/+1
2018-10-09Merge pull request #10307 from poettering/portable-pathZbigniew Jędrzejewski-Szmek1-7/+8
finishing touches to portable services, and let's move portablectl to /usr/bin to make it official
2018-10-08efi: allow ESP validity checks to be turned offLennart Poettering1-0/+7
let's add an env var for this, as this really shouldn't be a top-level feature, as it turning off the validity checks certainly isn't advisable. Fixes: #4925
2018-10-08Merge pull request #10262 from keszybz/hibres-disableLennart Poettering1-0/+4
Switches to disable hibernation and/or resuming
2018-10-08man,docs: document the new unit file directory for attached imagesLennart Poettering1-7/+8
2018-10-08nspawn: optionally don't mount a tmpfs over /tmp (#10294)Lennart Poettering1-0/+3
nspawn: optionally, don't mount a tmpfs on /tmp Fixes: #10260
2018-10-08Add $SYSTEMD_IN_INITRD=yes|no override for debuggingZbigniew Jędrzejewski-Szmek1-0/+4
2018-10-02Docs: Update CoC with email alias for David StraussDavid Strauss1-1/+1
2018-10-02docs: add a simple, auto-generated index.mdLennart Poettering1-0/+25
This is useful for the github pages feature
2018-10-02Set theme jekyll-theme-modernistLennart Poettering1-1/+1
2018-10-02Set theme jekyll-theme-tactileLennart Poettering1-1/+1
2018-10-02coc: spell systemd in the one-and-only correct wayZbigniew Jędrzejewski-Szmek1-1/+1
2018-10-02coc: reword the sentence about individual contactZbigniew Jędrzejewski-Szmek1-1/+1
It wasn't clear enough: https://github.com/systemd/systemd/pull/10233#discussion_r221734060
2018-10-02docs: rename file to appease githubZbigniew Jędrzejewski-Szmek1-0/+0
Hopefully this will be enough to let github notice that we have a coc now and display the green checkmark: https://github.com/systemd/systemd/pull/10233#issuecomment-425918447
2018-10-01Add a simple code of conduct based on ruby community guidelinesZbigniew Jędrzejewski-Szmek1-0/+14
This was discussed at the systemd hackfest during ASG2018, and we agreed to use the Ruby text [1] with the enforcement clause based on the "contributor covenant". I obviously modified the text where applicable to refer to systemd. [1] https://www.ruby-lang.org/en/conduct/ Fixes 10148.
2018-09-26Make Watchdog Signal ConfigurableAnita Zhang1-0/+1
Allows configuring the watchdog signal (with a default of SIGABRT). This allows an alternative to SIGABRT when coredumps are not desirable. Appropriate references to SIGABRT or aborting were renamed to reflect more liberal watchdog signals. Closes #8658
2018-09-25docs: clarify controller mount logic in hybrid cgroups modeLennart Poettering1-4/+8
Fixes: #10107
2018-09-25docs: fix CONTRIBUTING path (#10160)Lennart Poettering1-1/+1
2018-09-12Set theme jekyll-theme-slateZbigniew Jędrzejewski-Szmek1-0/+1
2018-09-08docs: convert TRANSLATORS to MarkdownFilipe Brandenburger2-27/+74
Also expand it to cover typical tasks of creating new translations, updating existing ones and compiling them (which can be useful to check syntax.)
2018-09-08docs: convert DISTRO_PORTING to MarkdownFilipe Brandenburger2-71/+75
2018-09-08docs: move markdown docs from .github/ to docs/Filipe Brandenburger3-1/+50
The GitHub guide on contributing file says: "Decide whether to store your contributing guidelines in your repository's root, docs, or .github directory." https://help.github.com/articles/setting-guidelines-for-repository-contributors/#adding-a-contributing-file But there's really no advantage to keeping it in the hidden .github/, since these are public and really belong together with the other documentation. We can still keep the issue templates under .github/, since they are not really documentation on their own. Updated the links pointing to CONTRIBUTING.md to refer to the one in docs/.
2018-09-08docs: move doc/ to docs/Filipe Brandenburger15-0/+2525
The docs/ directory is special in GitHub, since it can be used to serve GitHub Pages from, so there's a benefit to switching to it in order to expose it directly as a website. Updated references to it from the documentations themselves, from the CONTRIBUTING.md file and from Meson build files.
2018-03-28doc: merge docs/ dir → doc/Lennart Poettering4-105/+0
It's weird having two subdirs for documentation, let's unify this in one.
2017-11-19Add license headers and SPDX identifiers to meson.build filesZbigniew Jędrzejewski-Szmek2-0/+34
So far I avoided adding license headers to meson files, but they are pretty big and important and should carry license headers like everything else. I added my own copyright, even though other people modified those files too. But this is mostly symbolic, so I hope that's OK.
2017-10-04build-sys: use #if Y instead of #ifdef Y everywhereZbigniew Jędrzejewski-Szmek2-2/+2
The advantage is that is the name is mispellt, cpp will warn us. $ git grep -Ee "conf.set\('(HAVE|ENABLE)_" -l|xargs sed -r -i "s/conf.set\('(HAVE|ENABLE)_/conf.set10('\1_/" $ git grep -Ee '#ifn?def (HAVE|ENABLE)' -l|xargs sed -r -i 's/#ifdef (HAVE|ENABLE)/#if \1/; s/#ifndef (HAVE|ENABLE)/#if ! \1/;' $ git grep -Ee 'if.*defined\(HAVE' -l|xargs sed -i -r 's/defined\((HAVE_[A-Z0-9_]*)\)/\1/g' $ git grep -Ee 'if.*defined\(ENABLE' -l|xargs sed -i -r 's/defined\((ENABLE_[A-Z0-9_]*)\)/\1/g' + manual changes to meson.build squash! build-sys: use #if Y instead of #ifdef Y everywhere v2: - fix incorrect setting of HAVE_LIBIDN2
2017-07-18build-sys: drop gitignore patterns for in-tree buildsZbigniew Jędrzejewski-Szmek3-3/+0
... and other autotools-generated files.
2017-07-18build-sys: drop automake supportZbigniew Jędrzejewski-Szmek3-3/+0
v2: - also mention m4
2017-05-02meson: use booleans for conf.set and drop unecessary conditionalsZbigniew Jędrzejewski-Szmek2-2/+2
Using conf.set() with a boolean argument does the right thing: either #ifdef or #undef. This means that conf.set can be used unconditionally. Previously I used '1' as the placeholder value, and that needs to be changed to 'true' for consistency (under meson 1 cannot be used in boolean context). All checks need to be adjusted.
2017-04-27meson: do not install files from disabled features (#5811)userwithuid2-4/+10
Mirror conditions from Makefile.am.
2017-04-23meson: reindent all files with 8 spacesZbigniew Jędrzejewski-Szmek2-10/+6
The indentation for emacs'es meson-mode is added .dir-locals. All files are reindented automatically, using the lasest meson-mode from git. Indentation should now be fairly consistent.
2017-04-23meson: build systemd using mesonZbigniew Jędrzejewski-Szmek2-0/+16
It's crucial that we can build systemd using VS2010! ... er, wait, no, that's not the official reason. We need to shed old systems by requring python 3! Oh, no, it's something else. Maybe we need to throw out 345 years of knowlege accumulated in autotools? Whatever, this new thing is cool and shiny, let's use it. This is not complete, I'm throwing it out here for your amusement and critique. - rules for sd-boot are missing. Those might be quite complicated. - rules for tests are missing too. Those are probably quite simple and repetitive, but there's lots of them. - it's likely that I didn't get all the conditions right, I only tested "full" compilation where most deps are provided and nothing is disabled. - busname.target and all .busname units are skipped on purpose. Otherwise, installation into $DESTDIR has the same list of files and the autoconf install, except for .la files. It'd be great if people had a careful look at all the library linking options. I added stuff until things compiled, and in the end there's much less linking then in the old system. But it seems that there's still a lot of unnecessary deps. meson has a `shared_module` statement, which sounds like something appropriate for our nss and pam modules. Unfortunately, I couldn't get it to work. For the nss modules, we need an .so version of '2', but `shared_module` disallows the version argument. For the pam module, it also didn't work, I forgot the reason. The handling of .m4 and .in and .m4.in files is rather awkward. It's likely that this could be simplified. If make support is ever dropped, I think it'd make sense to switch to a different templating system so that two different languages and not required, which would make everything simpler yet. v2: - use get_pkgconfig_variable - use sh not bash - use add_project_arguments v3: - drop required:true and fix progs/prog typo v4: - use find_library('bz2') - add TTY_GID definition - define __SANE_USERSPACE_TYPES__ - use join_paths(prefix, ...) is used on all paths to make them all absolute v5: - replace all declare_dependency's with [] - add more conf.get guards around optional components v6: - drop -pipe, -Wall which are the default in meson - use compiler.has_function() and compiler.has_header_symbol instead of the hand-rolled checks. - fix duplication in 'liblibsystemd' library name - use the right .sym file for pam_systemd - rename 'compiler' to 'cc': shorter, and more idiomatic. v7: - use ENABLE_ENVIRONMENT_D not HAVE_ENVIRONMENT_D - rename prefix to prefixdir, rootprefix to rootprefixdir ("prefix" is too common of a name and too easy to overwrite by mistake) - wrap more stuff with conf.get('ENABLE...') == 1 - use rootprefix=='/' and rootbindir as install_dir, to fix paths under split-usr==true. v8: - use .split() also for src/coredump. Now everything is consistent ;) - add rootlibdir option and use it on the libraries that require it v9: - indentation v10: - fix check for qrencode and libaudit v11: - unify handling of executable paths, provide options for all progs This makes the meson build behave slightly differently than the autoconf-based one, because we always first try to find the executable in the filesystem, and fall back to the default. I think different handling of loadkeys, setfont, and telinit was just a historical accident. In addition to checking in $PATH, also check /usr/sbin/, /sbin for programs. In Fedora $PATH includes /usr/sbin, (and /sbin is is a symlink to /usr/sbin), but in Debian, those directories are not included in the path. C.f. https://github.com/mesonbuild/meson/issues/1576. - call all the options 'xxx-path' for clarity. - sort man/rules/meson.build properly so it's stable
2017-02-21docs: use https:// in URLsAsciiWolf1-1/+1
2015-07-06docs: add .gitignoreKay Sievers1-0/+1
2015-06-29docs: remove stale .gitignoreTom Gundersen1-1/+0
This is no longer useful as the udev docs are gone.
2015-06-03remove gudev and gtk-docKay Sievers13-600/+0
The library moved to: https://git.gnome.org/browse/libgudev/
2014-12-14build-sys: fix distcheckDave Reisner1-1/+1
- fix misspelling in filename (intenal -> internal) - remove deleted hwdb-related file (nuked with sd-hwdb refactor)