From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham autolearn_force=no version=3.4.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 541D37D043 for ; Tue, 26 Jun 2018 04:56:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1750972AbeFZE4U (ORCPT ); Tue, 26 Jun 2018 00:56:20 -0400 Received: from lgeamrelo12.lge.com ([156.147.23.52]:41487 "EHLO lgeamrelo11.lge.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750909AbeFZE4U (ORCPT ); Tue, 26 Jun 2018 00:56:20 -0400 Received: from unknown (HELO lgemrelse6q.lge.com) (156.147.1.121) by 156.147.23.52 with ESMTP; 26 Jun 2018 13:56:17 +0900 X-Original-SENDERIP: 156.147.1.121 X-Original-MAILFROM: byungchul.park@lge.com Received: from unknown (HELO X58A-UD3R) (10.177.222.33) by 156.147.1.121 with ESMTP; 26 Jun 2018 13:56:16 +0900 X-Original-SENDERIP: 10.177.222.33 X-Original-MAILFROM: byungchul.park@lge.com Date: Tue, 26 Jun 2018 13:56:09 +0900 From: Byungchul Park To: sjpark Cc: paulmck@linux.vnet.ibm.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, kernel-team@lge.com Subject: Re: [PATCH] locking/memory-barriers.txt/kokr: Update Korean translation to fix broken DMA vs. MMIO ordering example Message-ID: <20180626045609.GB20783@X58A-UD3R> References: <20180617051608.2128-1-sj38.park@gmail.com> <20180626004738.GA20783@X58A-UD3R> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Tue, Jun 26, 2018 at 12:21:23PM +0900, sjpark wrote: > Hello Byungchul, > > > On Tue, 26 Jun 2018, Byungchul Park wrote: > > > On Sun, Jun 17, 2018 at 02:16:08PM +0900, SeongJae Park wrote: > > > Translate this commit to Korean: > > > > > > 5846581e3563 ("locking/memory-barriers.txt: Fix broken DMA vs. MMIO ordering example") > > > > Hi SeongJae, > > > > You keep doing good jobs ;) > > > > I believe it would be better if you consider the little things below > > more. What do you think about it, SeongJae? > > Thank you for great comments! > > > > > > Signed-off-by: SeongJae Park > > > --- > > > Documentation/translations/ko_KR/memory-barriers.txt | 15 +++++++-------- > > > 1 file changed, 7 insertions(+), 8 deletions(-) > > > > > > diff --git a/Documentation/translations/ko_KR/memory-barriers.txt b/Documentation/translations/ko_KR/memory-barriers.txt > > > index 921739d00f69..ada0a709cce1 100644 > > > --- a/Documentation/translations/ko_KR/memory-barriers.txt > > > +++ b/Documentation/translations/ko_KR/memory-barriers.txt > > > @@ -1891,19 +1891,18 @@ Mandatory 배리어들은 SMP 시스템에서도 UP 시스템에서도 SMP 효 > > > /* 소유권을 수정 */ > > > desc->status = DEVICE_OWN; > > > > > > - /* MMIO 를 통해 디바이스에 공지를 하기 전에 메모리를 동기화 */ > > > - wmb(); > > > - > > > /* 업데이트된 디스크립터의 디바이스에 공지 */ > > > writel(DESC_NOTIFY, doorbell); > > > } > > > > > > dma_rmb() 는 디스크립터로부터 데이터를 읽어오기 전에 디바이스가 소유권을 > > > - 내놓았음을 보장하게 하고, dma_wmb() 는 디바이스가 자신이 소유권을 다시 > > > - 가졌음을 보기 전에 디스크립터에 데이터가 쓰였음을 보장합니다. wmb() 는 > > > - 캐시 일관성이 없는 (cache incoherent) MMIO 영역에 쓰기를 시도하기 전에 > > > - 캐시 일관성이 있는 메모리 (cache coherent memory) 쓰기가 완료되었음을 > > > - 보장해주기 위해 필요합니다. > > > + 내려놓았을 것을 보장하고, dma_wmb() 는 디바이스가 자신이 소유권을 다시 > > > + 가졌음을 보기 전에 디스크립터에 데이터가 쓰였을 것을 보장합니다. writel() > > ^ > > 참고로, > > Nice comment. This will enhance the readability a lot. Could you add this, too? A quite little thing tho. > > > + 을 사용하면 캐시 일관성이 있는 메모리 (cache coherent memory) 쓰기가 MMIO > > > + 영역에의 쓰기 전에 완료되었을 것을 보장하므로 writel() 앞에 wmb() 를 > > > + 실행할 필요가 없음을 알아두시기 바랍니다. writel() 보다 비용이 저렴한 > > > + writel_relaxed() 는 이런 보장을 제공하지 않으므로 여기선 사용되지 않아야 > > > + 합니다. > > > > > > consistent memory 에 대한 자세한 내용을 위해선 Documentation/DMA-API.txt > > > 문서를 참고하세요. > > > > See the subsection "Kernel I/O barrier effects" for more information on > > relaxed I/O accessors and the Documentation/DMA-API.txt file for more > > information on consistent memory. > > > > Don't you think the whole sentence need to be translated? If yes, then > > it would be better to do that as well ;) > > Oh, my mistake! It should be. > > I applied your comments to the second version. Thank you SeongJae :) > Thanks, > SeongJae Park > > > > > > -- > > > 2.13.0 > > > > -- > > Thanks, > > Byungchul > > -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html