How to use "setuid-program"?

How to use "setuid-program"?

[Matthew Brooks]

The old way of doing setuid programs:

(setuid-programs
  (cons
   #~(string-append #$slock "/bin/slock")
   %setuid-programs
   )
  )

now gives a deprecation warning as follows:
>warning: representing setuid programs with file-like objects is deprecated; use 'setuid-program' instead

The actual manual, however, still lists the old way as the way to do it. As such, I haven't been able to work out what sytax is actually expected for defining a setuid program with "setuid-program".

I assume that someone familiar with guile could probably check the definition of "setuid-program" or something to determine what it expects, but I have no idea how to do that either.

Re: How to use "setuid-program"?

[Tobias Geerinckx-Rice]

[-- Attachment #1: Type: text/plain, Size: 254 bytes --]

Hi Matthew,

Matthew Brooks 写道：
> The actual manual, however, still lists the old way as the way 
> to do it.

No: 
<https://guix.gnu.org/manual/devel/en/guix.html#Setuid-Programs>. 
Which one are you consulting?

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 247 bytes --]

Re: How to use "setuid-program"?

[Julien Lepiller]

Instead of the cold reply, here's an explanation. The /manual corresponds to the stable manual (1.3), and /manual/devel to the current manual.

You will find the links on the website if you hover the help menu.

You can also use "info guix" locally to get the mamual matching the current guix you have.

Le 3 septembre 2021 14:49:48 GMT-04:00, Tobias Geerinckx-Rice <me@tobias.gr> a écrit :
>Hi Matthew,
>
>Matthew Brooks 写道：
>> The actual manual, however, still lists the old way as the way 
>> to do it.
>
>No: 
><https://guix.gnu.org/manual/devel/en/guix.html#Setuid-Programs>. 
>Which one are you consulting?
>
>Kind regards,
>
>T G-R

Re: How to use "setuid-program"?

[Matthew Brooks]

Thanks! I didn't realize there were two versions of the manual, and had been checking the stable one. The /devel one did have the new method, and it worked fine.

On Fri, 03 Sep 2021 16:16:27 -0400
Julien Lepiller <julien@lepiller.eu> wrote:

> Instead of the cold reply, here's an explanation. The /manual corresponds to the stable manual (1.3), and /manual/devel to the current manual.
> 
> You will find the links on the website if you hover the help menu.
> 
> You can also use "info guix" locally to get the mamual matching the current guix you have.
> 
> Le 3 septembre 2021 14:49:48 GMT-04:00, Tobias Geerinckx-Rice <me@tobias.gr> a écrit :
> >Hi Matthew,
> >
> >Matthew Brooks 写道：  
> >> The actual manual, however, still lists the old way as the way 
> >> to do it.  
> >
> >No: 
> ><https://guix.gnu.org/manual/devel/en/guix.html#Setuid-Programs>. 
> >Which one are you consulting?
> >
> >Kind regards,
> >
> >T G-R  

Re: How to use "setuid-program"?

[Tobias Geerinckx-Rice]

[-- Attachment #1: Type: text/plain, Size: 661 bytes --]

Matthew Brooks 写道：
> Thanks! I didn't realize there were two versions of the manual, 
> and had been checking the stable one.

This state is extremely confusing and should be improved.  How did 
you search/browse to the ‘stable’ manual?

More generally: why did you end up loading a browser to look for 
the manual on the Web, instead of consulting the one on your Guix 
machine?  Were you aware of it?  Would you have seen a warning at 
the top of the page, or did you click straight through to a 
section/chapter?  Consider this low-budget telemetry to find out 
how better to point users to other options ;-)

Kind regards,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 247 bytes --]

Re: How to use "setuid-program"?

[Pascal Lorenz]

What do you think about merging both entries of the manual in the main menu of the page and let it display a page in this vein:

NU Guix Reference Manual

This document is available in the following languages:

| language | current ("developer")     | Version (1.3.) ("stable")          |
|----------+---------------------------+------------------------------------|
| Deutsch  |[[https://guix.gnu.org/manual/devel/de/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/de/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/de/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/de/html_node][HTML]],  [[https://guix.gnu.org/manual/de/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/de/guix.pdf][PDF]] |
| English   |[[https://guix.gnu.org/manual/devel/en/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/en/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/en/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/en/html_node][HTML]],  [[https://guix.gnu.org/manual/en/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/en/guix.pdf][PDF]] |
| Español  |[[https://guix.gnu.org/manual/devel/es/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/es/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/es/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/es/html_node][HTML]],  [[https://guix.gnu.org/manual/es/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/es/guix.pdf][PDF]] |
| français  |[[https://guix.gnu.org/manual/devel/fr/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/fr/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/fr/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/fr/html_node][HTML]],  [[https://guix.gnu.org/manual/fr/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/fr/guix.pdf][PDF]] |
| русский   |[[https://guix.gnu.org/manual/devel/ru/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/ru/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/ru/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/ru/html_node][HTML]],  [[https://guix.gnu.org/manual/ru/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/ru/guix.pdf][PDF]] |
| 中文     |[[https://guix.gnu.org/manual/devel/zh-cn/html_node][HTML]],  [[https://guix.gnu.org/manual/devel/zh-cn/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/devel/zh-cn/guix.pdf][PDF]] |[[https://guix.gnu.org/manual/zh-cn/html_node][HTML]],  [[https://guix.gnu.org/manual/zh-cn/guix.html][HTML (single page)]],  [[https://guix.gnu.org/manual/zh-cn/guix.pdf][PDF]] |


  * If you computer is already running Guix, running `info guix` is probably the best way to read the current documentation
  * If unsure, the "stable" documentation is probably not the one you are looking for
  * You might also want to download the [[https://guix.gnu.org/guix-refcard.pdf][Guix reference card]]
  * Or have a look at the cookbook, accessible via `info guix-cookbook` or [[https://guix.gnu.org/cookbook/][online]].
    It contains tutorials, how-to guides and examples contributed by the Guix community which show you how to use the system and its collection of packages to achieve common and not-so-common goals users may have.
  * There is also a [[https://libreplanet.org/wiki/Group:Guix][wiki]] & [[https://guix.gnu.org/en/videos/][videos]]
  * If you need help, there are the IRC, the mailing lists and their archives available at [[https://guix.gnu.org/en/contact/][guix.gnu.org/en/contact]] 
     
?

Am I right in assuming that the stable version of the manual is only useful before the first pull?

Is there a way to display the reference card on the system without grabbing the pdf? And: it would be nicer if the orientation of the pages in the pdf was rotated


Kind Regards,

Pascal


> On 17. Sep 2021, at 18:47, Tobias Geerinckx-Rice <me@tobias.gr> wrote:
> 
> Matthew Brooks 写道：
>> Thanks! I didn't realize there were two versions of the manual, and had been checking the stable one.
> 
> This state is extremely confusing and should be improved.  How did you search/browse to the ‘stable’ manual?
> 
> More generally: why did you end up loading a browser to look for the manual on the Web, instead of consulting the one on your Guix machine?  Were you aware of it?  Would you have seen a warning at the top of the page, or did you click straight through to a section/chapter?  Consider this low-budget telemetry to find out how better to point users to other options ;-)
> 
> Kind regards,
> 
> T G-R

Re: How to use "setuid-program"?

[Efraim Flashner]

[-- Attachment #1: Type: text/plain, Size: 1094 bytes --]

On Fri, Sep 17, 2021 at 06:47:36PM +0200, Tobias Geerinckx-Rice wrote:
> Matthew Brooks 写道：
> > Thanks! I didn't realize there were two versions of the manual, and had
> > been checking the stable one.
> 
> This state is extremely confusing and should be improved.  How did you
> search/browse to the ‘stable’ manual?
> 
> More generally: why did you end up loading a browser to look for the manual
> on the Web, instead of consulting the one on your Guix machine?  Were you
> aware of it?  Would you have seen a warning at the top of the page, or did
> you click straight through to a section/chapter?  Consider this low-budget
> telemetry to find out how better to point users to other options ;-)
> 
> Kind regards,
> 
> T G-R

I normally check it on the website. I've been toying with writing an
nginx service to serve the html version locally.


-- 
Efraim Flashner   <efraim@flashner.co.il>   רנשלפ םירפא
GPG key = A28B F40C 3E55 1372 662D  14F7 41AA E7DC CA3D 8351
Confidentiality cannot be guaranteed on emails sent or received unencrypted

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: How to use "setuid-program"?

[Leo Famulari]

On Sun, Sep 19, 2021 at 02:37:51PM +0300, Efraim Flashner wrote:
> I normally check it on the website. I've been toying with writing an
> nginx service to serve the html version locally.

That would be really cool. I also prefer using a web browser to read the
manual. I wonder if there are any security risks to running a web server
locally?