From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-lf1-x143.google.com (mail-lf1-x143.google.com [IPv6:2a00:1450:4864:20::143]) by sourceware.org (Postfix) with ESMTPS id 70C463857C59 for ; Tue, 28 Jul 2020 19:33:22 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 70C463857C59 Received: by mail-lf1-x143.google.com with SMTP id k13so11677277lfo.0 for ; Tue, 28 Jul 2020 12:33:22 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=S5Wb6R4WiCHcXO7NL1xbeG2d7/MG3DOpyhAHaYDsbVM=; b=kZEwNNcdDtjUmkfiHjjsBdkV7AjzQuQYbt7T2HBfNyL7m7jY7EW9zM+V0rA0uK/DmH KkJF86Fyc+/w1Ma2BbO4H7mivxWSGe0EoxeNGgghQyjY6o67fVr4NkMenVGM5weiciRK QOFVcSkbswYo/RwPxq6st5OnhBHI/lkUnnQMl/S9f1w/m9iZr5ScWbsPZlDEsKOXAT5v 7v5CQUPYvCjb1wL/3bjP2mFTv947Y9cO+u11GplYrog+Q7lVNYikTLO4syiB67L+0f/o 0UZScfDpmMhEEm31D3AcILk+B9elQl/iIz02LxyRjvKA0LJikDQTebN+fSMhLdDdlB8n ky4A== X-Gm-Message-State: AOAM533WOrdyag2rxZ1hc6cyRC9C1ETy7vVNvQLo3E7bVWDBOitN9FdY YPRp2c4zT1wazbSoSAaL5DgrT1M6lbehTaaSXS+R6g== X-Google-Smtp-Source: ABdhPJxKECE+LN0BETkbOiGa9v1f2ZMIhfd9iq1WIXD4pEaS9+ezL6CG+k0AvkYIGs1NWROarWyRS7bo+of1xdmMUdQ= X-Received: by 2002:a19:70c:: with SMTP id 12mr15505539lfh.207.1595964800992; Tue, 28 Jul 2020 12:33:20 -0700 (PDT) MIME-Version: 1.0 References: <423fbe8b-6b41-d9e8-c4a2-5865d8eeec4b@gmail.com> <990ea0cb-1997-9ad4-e0ea-f5ba54e22066@gmail.com> <5a6b13e9-e0f7-e8a9-d07b-303e87237b4a@gmail.com> In-Reply-To: <5a6b13e9-e0f7-e8a9-d07b-303e87237b4a@gmail.com> From: enh Date: Tue, 28 Jul 2020 12:33:07 -0700 Message-ID: Subject: Re: Pseudoterminal terminology (was Re: Rename "master" branch to "main"?) To: "Michael Kerrisk (man-pages)" Cc: Zack Weinberg , "Carlos O'Donell" , libc-alpha , "Joseph S. Myers" , Florian Weimer , Paul Eggert X-Spam-Status: No, score=-17.4 required=5.0 tests=BAYES_00, DKIMWL_WL_MED, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, ENV_AND_HDR_SPF_MATCH, HTML_MESSAGE, KAM_SHORT, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP, USER_IN_DEF_DKIM_WL, USER_IN_DEF_SPF_WL autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org Content-Type: text/plain; charset="UTF-8" X-Content-Filtered-By: Mailman/MimeDel 2.1.29 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-List-Received-Date: Tue, 28 Jul 2020 19:33:25 -0000 On Tue, Jul 28, 2020 at 12:27 PM Michael Kerrisk (man-pages) < mtk.manpages@gmail.com> wrote: > On 7/28/20 8:47 PM, enh wrote: > [...] > > > parent/child might be a good choice for the related forkpty(). (given > > bionic's "you'll probably be looking at this in Android Studio or Visual > > Studio Code's argument name completion UI, so let's use a longer name to > > save you a trip to the man page if you know roughly what you're doing but > > can't remember what order the arguments are in" style, that would > probably > > still be `int forkpty(int* _Nonnull __parent_pty_fd, char* _Nullable > > __child_tty_name, ...`.) > > > > (note also that the man page for forkpty() seems to be the only place the > > return type is given as pid_t rather than int --- afaict all the libcs > > actually use int?) > > The manual page seems to have been lifted (many years ago, before my > time) from OpenBSD, where the return type really is pid_t. > (ah, yes: the other BSDs and macOS too. it's bionic/glibc/musl that all have int.) > I wonder what the implications of changing this in glibc are? Or maybe > the manual page just needs to be changed. > (certainly macOS/OpenBSD's forkpty lives in and libutil, so the man page isn't quite right for them either :-) [though NetBSD seems to have it in pty.h. "if you know one BSD, you know one BSD..."]) > Thanks, > > Michael > > -- > Michael Kerrisk > Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ > Linux/UNIX System Programming Training: http://man7.org/training/ >