lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  PHC 
Open Source and information security mailing list archives
 
Hash Suite for Android: free password hash cracker in your pocket
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date:   Mon, 11 May 2020 17:25:44 +0200
From:   Daniel Borkmann <daniel@...earbox.net>
To:     Quentin Monnet <quentin@...valent.com>,
        Alexei Starovoitov <ast@...nel.org>
Cc:     bpf@...r.kernel.org, netdev@...r.kernel.org
Subject: Re: [PATCH bpf-next 2/4] tools: bpftool: minor fixes for
 documentation

On 5/11/20 3:38 PM, Quentin Monnet wrote:
> Bring minor improvements to bpftool documentation. Fix or harmonise
> formatting, update map types (including in interactive help), improve
> description for "map create", fix a build warning due to a missing line
> after the double-colon for the "bpftool prog profile" example,
> complete/harmonise/sort the list of related bpftool man pages in
> footers.
> 
> Signed-off-by: Quentin Monnet <quentin@...valent.com>
[...]
> @@ -116,24 +123,24 @@ DESCRIPTION
>   		  receiving events if it installed its rings earlier.
>   
>   	**bpftool map peek**  *MAP*
> -		  Peek next **value** in the queue or stack.
> +		  Peek next value in the queue or stack.

Looks great overall. Was about to push, but noticed above inconsistency. Should this
be `*VALUE*` as well?

>   	**bpftool map push**  *MAP* **value** *VALUE*
> -		  Push **value** onto the stack.
> +		  Push *VALUE* onto the stack.
>   
>   	**bpftool map pop**  *MAP*
> -		  Pop and print **value** from the stack.
> +		  Pop and print *VALUE* from the stack.
>   
>   	**bpftool map enqueue**  *MAP* **value** *VALUE*
> -		  Enqueue **value** into the queue.
> +		  Enqueue *VALUE* into the queue.
>   
>   	**bpftool map dequeue**  *MAP*
> -		  Dequeue and print **value** from the queue.
> +		  Dequeue and print *VALUE* from the queue.
>   
>   	**bpftool map freeze**  *MAP*
>   		  Freeze the map as read-only from user space. Entries from a
>   		  frozen map can not longer be updated or deleted with the
> -		  **bpf\ ()** system call. This operation is not reversible,
> +		  **bpf**\ () system call. This operation is not reversible,
>   		  and the map remains immutable from user space until its
>   		  destruction. However, read and write permissions for BPF
>   		  programs to the map remain unchanged.

Powered by blists - more mailing lists