From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 9AA153858D20 for ; Fri, 17 May 2024 13:21:14 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 9AA153858D20 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 9AA153858D20 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1715952076; cv=none; b=Zu4YNbGHwJf1lz/lOWXOq64hKF07B7ECzY02HiVKkSLqj/DDoxppTu72U4IjPHY3QD+VM5FEPBd1QbQKrXbxIhTbyuWkyjfRYqwCx/UNLAnXLf+Og5zUMLzk+MJk+20k4X+XSZmL7Yzk96R48LLhWuAN93AXqoikvigHJzGGKFM= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1715952076; c=relaxed/simple; bh=FR1K6Zq6Pu+HBXbN0mzH8R/G8tE1vI6TnSqpb0S8Sn8=; h=DKIM-Signature:Message-ID:Date:MIME-Version:Subject:To:From; b=jYHh8LNFO2vLQVZnN8Hy4HBho3E7pecyXBSu+0JfV0Tl3Mcwovb5Rd61sL67MMHXamWOapgoVz4eKAtSyJe2NeDu5NLhZY9/Bqa0pWCYmWEOiT64Rpie6Z7/opID1GNT+5zwYFEoNkgHgBAiDgVkkqmt3yP6JYWm2aEFWhsjWH4= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1715952074; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:autocrypt:autocrypt; bh=8YgAFT139x3d+R93PFpOAyFL0lP3ItFJl4nKdgsTUww=; b=Di4mSsZSI1d68KV1PY68PvH5CTUgJyJ99Z30Sd3f+/J45W8LWqTPTFkMaJQpiuNT9d32Nv lsMttXv1Vrf3AVrMg4yQBYL9bVcMUkB7KZLQusVzeRKcnsBF6EOPb9SilkhVFug6EQZJY/ Yr12SE/a/5T6f4x7kz0DN/HUgwlNoP4= Received: from mail-yw1-f197.google.com (mail-yw1-f197.google.com [209.85.128.197]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-675-36r9u5INO5alYm-aUlLcSw-1; Fri, 17 May 2024 09:21:13 -0400 X-MC-Unique: 36r9u5INO5alYm-aUlLcSw-1 Received: by mail-yw1-f197.google.com with SMTP id 00721157ae682-61c9e36888bso158741267b3.2 for ; Fri, 17 May 2024 06:21:12 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1715952072; x=1716556872; h=content-transfer-encoding:in-reply-to:organization:autocrypt:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=8YgAFT139x3d+R93PFpOAyFL0lP3ItFJl4nKdgsTUww=; b=ghRBV4F2TzPsVowOVy0TAGJx0yFt2xT5QyBgrPXY1dsR05MtRVLUQNnL49zhRI0KPd OOnk0ImH4/8K6L3yVy5YQdwzso0i27TPcHDGPR2JJNS2vdmBw9rw6OXuhREq036/ebp0 fImVFxPuixVt/SRL3T1ciAwWgutPRNTVWP20nUrF98pDZywLI1D9pg9Wfs7fKjS+JPZZ h2o1OQG/RHZ+/IRE4uSCplMmzu6AYC/4+g21PKQ8iXDT9HcOutiyberYskYbANpix+a7 yGODzWOj8uHO67nsDJENtwlv2PNNXsNZlwWDxkIutHzU0tgtK7nltdg8g42ftwZK5PLx iJlg== X-Forwarded-Encrypted: i=1; AJvYcCVIPmAEGY5n3hnckEOJTODNz10y/B0tIVlqS48M5upm8LEHTt0ux7jXGbCyjUQaPuvozi+awiwxp+mtzjylTOzAQRFbNOuoCJi/ X-Gm-Message-State: AOJu0YzHXLykxKww7NwuefTiSmFN12UKvw0RVITwlM4I1TOaciTn6DX1 8sY4ehmWsPgk2XGYrSpZdAHkU65TCR/PsZcvg0J7km6qTbynMA45551DEFlBC32LyWKEA+hswld EUy8/aT1Dolawsu1Bu7asWktJiPPSt2tQWXsv+av5i4uckCEbzIBWLsCXGw== X-Received: by 2002:a05:690c:fc7:b0:615:3e2c:d318 with SMTP id 00721157ae682-622affda599mr262475427b3.41.1715952072415; Fri, 17 May 2024 06:21:12 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEaj+MyavbazBcv/qGAtKqZI53WpJ+cxiIPvtX4MpSZFPLjGwQ4yVzGAX4+mSEjcjfnJW0oSQ== X-Received: by 2002:a05:690c:fc7:b0:615:3e2c:d318 with SMTP id 00721157ae682-622affda599mr262475147b3.41.1715952072077; Fri, 17 May 2024 06:21:12 -0700 (PDT) Received: from [192.168.0.241] ([198.48.244.52]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6a15f185491sm86289926d6.43.2024.05.17.06.21.11 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 17 May 2024 06:21:11 -0700 (PDT) Message-ID: <37acf984-f4eb-4df7-ba32-991322fae4fb@redhat.com> Date: Fri, 17 May 2024 09:21:10 -0400 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: manual: add syscall list appendix To: DJ Delorie Cc: fweimer@redhat.com, alx@kernel.org, libc-alpha@sourceware.org References: From: Carlos O'Donell Autocrypt: addr=carlos@redhat.com; keydata= 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 vjq6hMJAjA== Organization: Red Hat In-Reply-To: X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On 5/16/24 1:55 PM, DJ Delorie wrote: > "Carlos O'Donell" writes: >> This needs a configure argument to specify which version of the Linux man-pages project >> release is the version we've looked at to make sure we match the behaviour for the >> specified syscalls. >> >> I think we should specifically reference e.g. Linux man-pages X.Y. > > Can we make that optional? I.e. if *no* configure option is specified, > the wording is version-agnostic? Development in git likely doesn't care > which version of man-pages is current, and it would be continuously > changing anyway. We would only need to lock-step in released versions > of glibc, and then, we'd need to hard-code it somewhere as a default. $0.02. No. This is similar to the Linux kernel version checks. We should have a minimum and bump them up as we audit and review. >> What about syscalls that have cancellation? >> >> We should really split them out and document that we wrap them in special cancellation >> code (which will change a bit as I need to review Adhemerval's changes for that). > > I'll see what I can do ;-) > >> The intent is to say that if we didn't document anything in the glibc manual >> that users should feel free to go read the Linux man-pages documentaiton for >> that syscall. >> >> Thoughts? > > It's long for an appendix. Do we have a chapter on cancellation? Do we > want to be that Linux-centric? May you please expand on what you think is long for an appendix? There are 117 undocumented POSIX Thread APIs in glibc that we *really* need to document, but I am not asking you to document those. We do not talk about cancellation in the manual, but we should. I don't think we need to do that for this patch, but we should correctly note which have cancellation support and leave it at that. We can be as Linux-centric as we want... so long as the manual is accurate and describes these as Linux-specific things. We do this often in the manual. -- Cheers, Carlos.