git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2] config: honor file permission bits

From
Patrick Steinhardt <ps@pks.im>
Date
Nov 3, 2026, 10:34 UTC
Message-ID
<aum4pZp5P0ZRC-cf@pks.im>
In-Reply-To
<xmqqa4o0v76o.fsf@gitster.g>
On Mon, Oct 26, 2026 at 07:59:43AM -0700, Junio C Hamano wrote:
Show 14 quoted lines
> When dotfile sources are kept under version control, you might
> protect installed files like ~/.gitconfig from accidental changes by
> making them read-only.  This fails because updating a file writes a
> new lockfile, copies and tweaks the content, and renames the
> lockfile over the original.  The original file's permission bits are
> ignored in this process.
> 
> Teach the configuration writing machinery to inspect the original
> file's permissions with access(2) and avoid replacing it when the
> file should not be writable.
> 
> This implementation targets configuration files rather than the
> lockfile API layer.  While in-tree files like .git/index do not need
> such protection, out-of-tree files like ~/.gitconfig and its XDG
Nit: a curious reader might wonder why such in-tree files don't need
such protection.
> counterparts are unique in this regard.  System-wide configuration
> like /etc/gitconfig is typically in a directory already read-only to
> normal users, making the issue irrelevant there.
Thanks for adding the motivation.
Show 26 quoted lines
> diff --git a/config.c b/config.c
> index e0bb29b53d..2b84fb215c 100644
> --- a/config.c
> +++ b/config.c
> @@ -3066,6 +3066,28 @@ int repo_config_set_multivar_in_file_gently(struct repository *r,
>  	if (!config_filename)
>  		config_filename = filename_buf = repo_git_path(r, "config");
>  
> +	/*
> +	 * Do not allow updating a read-only configuration file; it is
> +	 * annoying and alarming that "chmod a-w $HOME/.gitconfig" does not
> +	 * prevent the global configuration file from getting clobbered by
> +	 * mistake with the usual "create a new lockfile, copy the original
> +	 * while setting a new value, propagate the permission bits to the
> +	 * lockfile, and then rename it to replace the original" dance.
> +	 */
> +	if (!access(config_filename, W_OK)) {
> +		; /* happy: we can write to it */
> +	} else if (errno == ENOENT) {
> +		; /* happy: we are creating this file anew */
> +	} else {
> +		/*
> +		 * most likely EACCES but other errors also indicate
> +		 * that we cannot write to it anyway.
> +		 */
> +		error_errno(_("file %s unwritable"), config_filename);

Should we quote '%s' here? The function is quite inconsistent, where it sometimes quotes and sometimes doesn't. I'd say that quoting is the better choice though.

Other than that this patch looks good to me, thanks!
Patrick
Previous: Junio C Hamano
Message 10 of 10 in “config: honor file permission bits”
  1. config: honor file permission bitsJunio C Hamano, Oct 19, 2026
  2. Junio C HamanoOct 22, 2026
  3. brian m. carlsonOct 22, 2026
  4. Junio C HamanoOct 22, 2026
  5. Patrick SteinhardtOct 23, 2026
  6. Junio C HamanoOct 23, 2026
  7. Patrick SteinhardtOct 26, 2026
  8. Junio C HamanoOct 26, 2026
  9. config: honor file permission bitsJunio C Hamano, Oct 26, 2026
  10. Patrick SteinhardtNov 3, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.