From patchwork Sat Oct 30 21:31:10 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 46820 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 956E03858002 for ; Sat, 30 Oct 2021 21:32:15 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 956E03858002 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1635629535; bh=fn/yC9dQ+cdFMTs7+hVYN9RwP973zbjYwKitz0z5vTU=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=lg8FZ6aGdT3tUkL4MDTmWaXIcItDTCEkQHvQNmPAObvZqEasUaQOB2z5OhD4Kh6pf Up/UtJzh5hDstDT9tGDM0/koAe+w9vdKh5KTZQLuQJbaYuz7lw/kw1lN4BoC/U2Wia +4RkRWZvCBkq5/vrWPPY4KDaoMP2aM1FqMLyNA24= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x436.google.com (mail-wr1-x436.google.com [IPv6:2a00:1450:4864:20::436]) by sourceware.org (Postfix) with ESMTPS id 180BC3858420 for ; Sat, 30 Oct 2021 21:31:54 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 180BC3858420 Received: by mail-wr1-x436.google.com with SMTP id i5so14556577wrb.2 for ; Sat, 30 Oct 2021 14:31:54 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=fn/yC9dQ+cdFMTs7+hVYN9RwP973zbjYwKitz0z5vTU=; b=uEZgZLCvMtFJGW1w8VgzNRfVEVblY3S+lkol2Ksj/uMxUY3gtJq/KTXh6L7dPYDETP 7ExR7Fw4I6ZlKC8xKnFUJ9KNSTdE3s9vf43bq1b6ExA6m05QxE8hh67bz6uKMPB9qM+h MAsALDOgCy1K/AGR/Z9AqY6RfUB/e+n715c2h/xzaOtu1dMjAwFnsjz5QyuzLdRYylZ4 JGDONjVUMJwapTJ1MH/GLTn47r7xmHE//pggkCc3kKxy5FaRwcvM0lnc4M27xrrXAatw nHjE8wGxp4CF/93uLy88HklEPrEKc0NiPUk4JxIH6dUdD2aojmD0TtWF1eHLvf16VDmG qkPw== X-Gm-Message-State: AOAM532gPp1lVDnaaxtcMdlyQ6KrHzCJA3B/CghuCsNImWuFCEkDa9B4 zvvqJ2e95Vi+2PkngaV/fHXuOb4O4cg= X-Google-Smtp-Source: ABdhPJy1v0IHl38vwJSQHkoCi+puWHJWUzjv7R9copvnZeJzlQK7zy1kwZCcF3L9vdk1Qp69r7gxIw== X-Received: by 2002:adf:aac5:: with SMTP id i5mr13643160wrc.67.1635629513034; Sat, 30 Oct 2021 14:31:53 -0700 (PDT) Received: from sqli.sqli.com ([195.53.121.100]) by smtp.googlemail.com with ESMTPSA id c79sm2948689wme.43.2021.10.30.14.31.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 30 Oct 2021 14:31:52 -0700 (PDT) To: mtk.manpages@gmail.com, linux-man@vger.kernel.org Subject: [PATCH 00/22] man2: Add [[deprecated]] attribute Date: Sat, 30 Oct 2021 23:31:10 +0200 Message-Id: <20211030213131.140429-1-alx.manpages@gmail.com> X-Mailer: git-send-email 2.33.1 MIME-Version: 1.0 X-Spam-Status: No, score=-5.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, git@vger.kernel.org Errors-To: libc-alpha-bounces+patchwork=sourceware.org@sourceware.org Sender: "Libc-alpha" Hello Michael, I added the C2X [[deprecated]] attribute to the prototypes of some system calls. All of the cases where I added that were already marked as deprecated or obsolete somewhere in the manual page, so this is just about uniformity and visual effect rather than a new deprecation notice. There are cases where the syscalls have been simply removed, and so they are obviously not to be used any more. There are cases where some implementation (not necessarily Linux) is dangerous. In some other cases, the functions have been obsoleted by POSIX, but are still there in Linux without any deprecation notices. In these cases, if there's no clear replacement, or if the replacement is not a straight drop-in, or if the replacement adds more complexity, I didn't add the [[deprecated]] attribute. A list of the system calls that I skipped in this patch set: - utime(2) Many filesystems have 1 second resolution, so it makes sense to use it in those cases. git(1) for example uses utime(2) consistently. Although deprecated by POSIX, it is still part of POSIX; if it ever removes it, we can reconsider. - setpgrp(2) (the POSIX/SysV version) POSIX deprecated it (not yet removed), but the manual page doesn't mention any replacement. Cheers, Alex --- Alejandro Colomar (22): bdflush.2: SYNOPSIS: Mark as [[deprecated]] create_module.2: SYNOPSIS: Mark as [[deprecated]] get_kernel_syms.2: SYNOPSIS: Mark as [[deprecated]] getunwind.2: SYNOPSIS: Mark as [[deprecated]] iopl.2: SYNOPSIS: Mark as [[deprecated]] query_module.2: SYNOPSIS: Mark as [[deprecated]] remap_file_pages.2: SYNOPSIS: Mark as [[deprecated]] sigprocmask.2: SYNOPSIS: Mark the legacy system call as [[deprecated]] statfs.2: SYNOPSIS: Mark as [[deprecated]] stime.2: SYNOPSIS: Mark as [[deprecated]] ustat.2: SYNOPSIS: Mark as [[deprecated]] pthread_mutex_consistent.3: Mark *_np() old function as [[deprecated]] sysctl.2: SYNOPSIS: Mark as [[deprecated]] vfork.2: SYNOPSIS: Mark as [[deprecated]] tkill.2: SYNOPSIS: Mark tkill() as [[deprecated]] sgetmask.2: SYNOPSIS: Mark as [[deprecated]] getitimer.2: SYNOPSIS: Mark as [[deprecated]] futimesat.2: SYNOPSIS: Mark as [[deprecated]] gettimeofday.2: SYNOPSIS: Mark as [[deprecated]] setpgid.2: SYNOPSIS: Mark BSD versions of getpgrp() and setpgrp() as [[deprecated]] sysfs.2: SYNOPSIS: Mark as [[deprecated]] uselib.2: SYNOPSIS: Mark as [[deprecated]] man2/bdflush.2 | 4 ++-- man2/create_module.2 | 2 +- man2/futimesat.2 | 4 ++-- man2/get_kernel_syms.2 | 2 +- man2/getitimer.2 | 7 ++++--- man2/gettimeofday.2 | 8 ++++---- man2/getunwind.2 | 3 ++- man2/iopl.2 | 2 +- man2/query_module.2 | 5 +++-- man2/remap_file_pages.2 | 5 +++-- man2/setpgid.2 | 8 ++++---- man2/sgetmask.2 | 4 ++-- man2/sigprocmask.2 | 12 +++++++----- man2/statfs.2 | 4 ++-- man2/stime.2 | 2 +- man2/sysctl.2 | 2 +- man2/sysfs.2 | 6 +++--- man2/tkill.2 | 2 +- man2/uselib.2 | 2 +- man2/ustat.2 | 2 +- man2/vfork.2 | 2 +- man3/pthread_mutex_consistent.3 | 1 + 22 files changed, 48 insertions(+), 41 deletions(-)