From owner-freebsd-questions@freebsd.org Thu Jan 19 04:03:36 2017 Return-Path: Delivered-To: freebsd-questions@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 19774CB7A33; Thu, 19 Jan 2017 04:03:36 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: from mail-pg0-x244.google.com (mail-pg0-x244.google.com [IPv6:2607:f8b0:400e:c05::244]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id E096B1897; Thu, 19 Jan 2017 04:03:35 +0000 (UTC) (envelope-from luzar722@gmail.com) Received: by mail-pg0-x244.google.com with SMTP id 194so3015828pgd.0; Wed, 18 Jan 2017 20:03:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=message-id:date:from:user-agent:mime-version:to:cc:subject :content-transfer-encoding; bh=3/jLDDPlslHTyrHIYgKybRco4rNt5U2mAfEr5m84k2M=; b=HoGiHq4GTcGWUW4QM9HyOasJX9OK2G5KwPUd07/WUGPmvR9F/L3oy/NocgOlRhaoz3 9C6AZEDO4OhWMpu53hNgJSlw0cME6n4X3felmToPeoxA0gbaiPjF7HBMKH0evPjuCu4U b7lUuaC+bIk8Z8mw0XiQCJko9/0nMAMTCyBypiC604C5SB8zjCI9NGCtgjOHzmXnur6a jHtj/xdcvuKmN4oE9PSqKIgfqMnnEzA1VDd/qpK5Xe4MfmbE+UjdwHdZQeEN7Q1ZCeIq Cv3COKVm2uFjMNBNFoyfKvN+VoEfpVwFr5k3xFj4aGJGJkk2NCw0/qCveVdWU9+EKlpy vlfA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:date:from:user-agent:mime-version:to :cc:subject:content-transfer-encoding; bh=3/jLDDPlslHTyrHIYgKybRco4rNt5U2mAfEr5m84k2M=; b=hj7mBZJXcZH2YfiMH053F5MzavyHsgmSiPi1Z7Ef9p4PHhJSWLqtxIW+TZrzAQQ1gH qe4ZLc2gQJevCTtL9jIsrjibwI8vkvdjroYxrXYt35Yak46qzJPNhJY7m8AmvMXKqwl+ Gd1MKltld/0QYqTE3wclmCMI51SY/E3sJpcXoL1MjgPWOJ5faZOLpSrJTd/SLoMgCa6Y 2D2+RW2ushpDWEYKaQ4dOw35obgqb7CgP9e3L59COfnJWtbv4MXXl1pwg3Ss05hrDZdN HQq1bxVhx16UpcHT72LYCnEn+IQPgqHjRxJXljK+dkGkmHMJIdjmrnZE0vmVEH9mGNvJ RgCg== X-Gm-Message-State: AIkVDXKmrSuQRYNEvd5zGV4k7sAUSpJP4qBOth6LDTk2yd4MFCCVrVMpqbjjF30Re1xctQ== X-Received: by 10.99.19.65 with SMTP id 1mr7876029pgt.153.1484798615367; Wed, 18 Jan 2017 20:03:35 -0800 (PST) Received: from [192.168.1.103] ([120.29.76.161]) by smtp.googlemail.com with ESMTPSA id f3sm4138482pfd.10.2017.01.18.20.03.34 (version=TLS1 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 18 Jan 2017 20:03:34 -0800 (PST) Message-ID: <58803AA1.4070603@gmail.com> Date: Thu, 19 Jan 2017 12:03:45 +0800 From: Ernie Luzar User-Agent: Thunderbird 2.0.0.24 (Windows/20100228) MIME-Version: 1.0 To: "freebsd-questions@freebsd.org" CC: "freebsd-doc@freebsd.org" Subject: handbook chapter 14. Jails is out of date Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Jan 2017 04:03:36 -0000 Was reading the handbook chapter 14 about jails. Found it very strange that it's based on the legacy rc.conf method. When you start a jail using that method a warning message is given saying the statements are being converted to jail.conf statements and that the user should migrate their jail definitions to the jail.conf format. I believe this happened with RELEASE 10.0. Here RELEASE 11.0 is out and all releases older than 10.3 are at "end of life" and still the handbook has not been updated to document the current jail.conf method. The rc.conf method is depreciated and may soon be up for removal from the base system. Enough time has elapsed already for user conversions that the rc.conf method documented in the handbook can be removed and replaced with jail.conf documentation without concern for backwards capability. Omitted from the jail chapter is information about how to drive public traffic to the desired target jail. The section on ezjail is inappropriate in the handbook. It's not proper to give a port utility such lengthly coverage. All that information should be covered in the ezjail man page manual or it's website. The ezjail section should be removed from the handbook. Listing ezjail as a utility for jail administration is ok only if the other jail utilities are also included in the listing. Can not be showing such personal bias in the public manual. I hope someone will work on this to make it happen. Ya I know, patches are welcome.